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PREFACE 


This Eighth Edition manual describes the lineal descendant of the original operating system pioneered by 
Ken Thompson and Dennis Ritchie in the Computing Science Research Center at AT&T Bell Laboratories. 
It is an experimental system, not a commercial prototype, which incorporates facilities from the Seventh 
Edition, System V, and Berkeley BSD 4.1. The distinctive theme of the Eighth Edition is distributed com- 
puting: Ritchie’s coroutine-based stream IO system and the Datakit™ virtual circuit switch realization by 
Lee McMahon and Bill Marshall provide the basis for networking, Peter Weinberger’s remote file systems 
make it painless, and Rob Pike’s software for the Teletype 5620 moves system action right out to the termi- 
nal. These facilities have spurred a host of programs for remote information services, interactive graphics, 
debugging, and simple fun. Many other people have contributed significantly, including, but not limited to 
L. Cardelli, T. A. Cargill, L. L. Cherry, R. J. Elliot, S. I. Feldman, F. T. Grampp, A. G. Hume, B. W. Ker- 
nighan, T. Killian, A. R. Koenig, M. E. Lesk, J. P. Linderman, B. N. Locanthi, M. S. Manasse, R. T. Mor- 
ris, T. Pavlidis, D. L. Presotto, J. D. Reiser, M. J. Shannon, B. Stroustrup, and N. Wilson. 
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February, 1985 
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INTRODUCTION TO VOLUME 1 


This volume gives descriptions of the publicly available features of the Eighth Edition system in use at the 
Computing Science Research Center of AT&T Bell Laboratories. It does not attempt to provide perspec- 
tive or tutorial information upon the UNIX® operating system, its facilities, or its implementation. Various 
documents on those topics are contained in Volume 2. In particular, for an overview see “The UNIX Time- 
Sharing System’ by Ritchie and Thompson; for a tutorial see “UNIX for Beginners’ by Kernighan. 


Within the area it surveys, this volume attempts to be timely, complete and concise. Where the latter two 
objectives conflict, the obvious is often left unsaid in favor of brevity. It is intended that each program be 
described as it is, not as it should be. Inevitably, this means that various sections will soon be out of date. 


The volume is divided into nine sections: 


Commands 

System calls 

Subroutines 

Special files 

File formats and conventions 

Games 

Data bases and language conventions 
Maintenance commands and procedures. 
Teletype 5620-related software. 
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Commands are programs intended to be invoked directly by the user, in contradistinction to subroutines, 
which are intended to be called by the user’s programs. Essential commands generally reside in directory 
/bin (for binary programs). Public programs also reside in /usr/bin. These directories are searched 
automatically by command interpreters. 


System calls are entries into the UNIX supervisor. The system call interface is identical to a C language 
procedure call; the equivalent C procedures are described in Section 2. 


An assortment of subroutines is available; they are described in section 3. The primary libraries in which 
they are kept are described in intro(3). Most of these routines are C functions. Fortran users should consult 
the port(3) mathematical library. 


The special files section 4 discusses the characteristics of each system ‘file’ that actually refers to an I/O 
device. 


The file formats and conventions section 5 documents the structure of particular kinds of files; for example, 
the form of the output of the loader and assembler is given. Excluded are files used by only one command, 
for example the assembler’s intermediate files. 


Games have been relegated to section 6 to keep them from contaminating the more staid information of sec- 
tion 1. 


Section 7 is a miscellaneous collection of information sources and conventions for various specialized lan- 
guages: character codes, macro packages for typesetting, news, weather, etc. 


The maintenance section 8 discusses commands and procedures not intended for use by the ordinary user. 
The commands and files described here are almost all kept in the directory /etc. 


Section 9 contains software intended for use with the Teletype 5620 terminal. In this category fall utilities 
that exploit the terminal and tools for writing code to run with or on it. 


Each section consists of a number of independent entries of a page or so each. The name of the entry is in 
the upper corners of its pages, together with the section number. Sections 3 and 9 have further substructure 


as described in their respective introductions. Entries within each section are alphabetized. The page num- 
bers of each entry start at 1; it is infeasible to number consecutively the pages of a document like this that is 
republished in many variant forms. 


All entries are based on a common format, not all parts of which necessarily appear. 


The name subsection lists the exact names of the commands and subroutines covered under the entry 
and gives a very short description of their purpose. 


The synopsis summarizes the use of the program being described. A few conventions are used, par- 
ticularly in the Commands subsection: 


Boldface words are considered literals, and are typed just as they appear. 


Square brackets [ ] around an argument indicate that the argument is optional. When an argu- 
ment is given as ‘name’, it always refers to a file name. 


Ellipses ‘...’ are used to show that the previous argument-prototype may be repeated. 


A final convention is used by the commands themselves. An argument beginning with a minus 
sign ‘—’ is often taken to mean some sort of option-specifying argument even if it appears in a 
position where a file name could appear. Therefore, it is unwise to have files whose names 
begin with ‘—’. 

The description subsection discusses in detail the subject at hand. 

The examples subsection illustrates interesting usage. 

The files subsection gives the names of files which are built into the program. 

The see also subsection gives pointers to related information. 


The diagnostics subsection discusses the diagnostic indications which may be produced. Messages 
which are intended to be self-explanatory are not listed. 


The bugs subsection gives known bugs and sometimes deficiencies. Occasionally also the suggested 
fix is described. 


Following this introduction are a permuted index and glossary. 


HOW TO GET STARTED 


This section sketches the basic information you need to get started on UNIX: how to log in and log out, how 
to communicate through your terminal, and how to run a program. See ‘UNIX for Beginners’ in Volume 2 
for a more complete introduction to the system. 


Logging in. You must call UNIX from an appropriate terminal. Most any ASCII terminal capable of full 
duplex operation and generating the entire character set can be used. You must also have a valid user name, 
which may be obtained, together with necessary telephone numbers, from the system administration. After 
a data connection is established, the login procedure depends on what kind of terminal you are using. 


Dial-up terminals: If there is a half/full duplex switch, set it at full-duplex. When you have established a 
data connection, the system types out a few characters, intended to be ‘login:’. If they appear as gibberish, 
the computer is sending at the wrong baud rate; depress the ‘break’ (or ‘interrupt’) key; this is a speed- 
independent signal to UNIX that a different speed terminal is in use. The system then will type ‘login:,’ this 
time at another speed. Continue depressing the break key until ‘login:’ appears in clear, then respond with 
your user name. From the TTY 37 terminal, and any other which has the ‘newline’ function (combined 
carriage return and linefeed), terminate each line you type with the ‘new line’ key, otherwise use the 
‘return’ key. 


Hard-wired terminals. Hard-wired terminals usually begin at the right speed, up to 9600 baud; otherwise 
the preceding instructions apply. 


For all terminals, it is important that you type your name in lower-case if possible; if you type upper-case 
letters, UNIX will assume that your terminal cannot generate lower-case letters and will translate all subse- 
quent upper-case letters to lower case. 


The evidence that you have successfully logged in is that a shell program will type a prompt (normally ‘$’) 


to you. (The shell is described below under ‘How to run a program.’) 


For more information, consult tabs(1), stty(1), or tset(1), which tell how to adjust terminal behavior, 
getty(8), which discusses the login sequence in more detail, and tty(4), which discusses terminal I/O. To 
arrange for these and other settings to be set automatically when the shell starts, provide a ‘.profile’ file as 
described in sh(1). 


Logging out. There are two ways to log out: 


Type an end-of-file indication (EOT character, control-d) to the shell. The shell will terminate and 
the ‘login:’ message will appear again. 
Simply hang up the phone. 

How to communicate through your terminal. When you type characters, a gnome deep in the system 


gathers your characters and saves them in a secret place. The characters will not be given to a program 
until you type a return (or newline), as described above in Logging in. 


UNIX terminal I/O is full-duplex. It has full read-ahead, which means that you can type at any time, even 
while a program is typing at you. Of course, if you type during output, the printed output will have the 
input characters interspersed. However, whatever you type will be saved up and interpreted in correct 
sequence. There is a limit to the amount of read-ahead, but it is generous and not likely to be exceeded 
unless the system is in trouble. When the read-ahead limit is exceeded, the system throws away all the 
saved characters. 


The character ‘@’ in typed input kills all the preceding characters in the line, so typing mistakes can be 
repaired on a single line. Also, the character ‘#’ erases the last character typed. (Most users prefer to use a 
backspace rather than ‘#’, and some prefer control-U instead of ‘@’; stty(1) can be used to arrange this.) 
Successive uses of ‘#’ erase characters back to, but not beyond, the beginning of the line. ‘@’ and ‘#’ can 
be transmitted to a program by preceding them with ‘\’. (So, to erase ‘\’, you need two ‘#’s). 


The ‘break’ or ‘interrupt’ key causes an interrupt signal, as does the ASCII ‘delete’ (or ‘rubout’) character, 
which is not passed to programs. This signal generally causes whatever program you are running to 
terminate. It is typically used to stop a long printout that you don’t want. However, programs can arrange 
either to ignore this signal altogether, or to be notified when it happens (instead of being terminated). The 
editor, ed(1), for example, catches interrupts and stops what it is doing, instead of terminating, so that an 
interrupt can be used to halt an editor printout without losing the file being edited. 


It is also possible to suspend output temporarily using “S (control-s) and later resume output with *Q. 


The quit signal is generated by typing the ASCII FS character. (FS appears many places on different termi- 
nals, most commonly as control-\ or control- |.) It not only causes a running program to terminate but also 
generates a file with the core image of the terminated process. Quit is useful for debugging. 


Besides adapting to the speed of the terminal, UNIX tries to be intelligent about whether you have a termi- 
nal with the newline function or whether it must be simulated with carriage-return and line-feed. In the lat- 
ter case, all input carriage returns are turned to newline characters (the standard line delimiter) and both a 
carriage return and a line feed are echoed to the terminal. 


Tab characters are used freely in UNIX source programs. If your terminal does not have the tab function, 
you can arrange to have them turned into spaces during output, and echoed as spaces during input. The sys- 
tem assumes that tabs are set every eight columns. Again, the stty(1) command will set or reset this mode. 
Tabs(1) can be used to set the tab stops automatically when necessary. 


How to run a program; the shell. When you have successfully logged in, a program called the shell is 
listening to your terminal. The shell reads typed-in lines, splits them up into a command name and 
arguments, and executes the command. A command is simply an executable program. The shell looks in 
several system directories to find the command. You can also place commands in your own directory and 
have the shell find them there. There is nothing special about system-provided commands except that they 
are kept in a directory where the shell can find them. 


The command name is always the first word on an input line; it and its arguments are separated from one 
another by spaces. 


When a program terminates, the shell will ordinarily regain control and type a prompt at you to indicate that 


it is ready for another command. 
The shell has many other capabilities, which are described in detail in sh(1). 


Bitmap terminals. If you have a Teletype 5620 terminal, you will probably wish to use mux(9), with 
mouse control, graphics, and multiple layers, each of which acts like a separate, simultaneously running 
UNIX terminal, complete with its own shell. 


The current directory. UNIX has a file system arranged in a hierarchy of directories. When the system 
administrator gave you a user name, he also created a directory for you (ordinarily with the same name as 
your user name). When you log in, any file name you type is by default in this directory. Since you are the 
owner of this directory, you have full permission to read, write, alter, or destroy its contents. Permissions 
to have your will with other directories and files will have been granted or denied to you by their owners. 
As a matter of observed fact, few UNIX users protect their files from perusal by other users. 


To change the current directory (but not the set of permissions you were endowed with at login) use cd(1). 


Path names. To refer to files not in the current directory, you must use a path name. Full path names 
begin with ‘/’, the name of the root directory of the whole file system. After the slash comes the name of 
each directory containing the next sub-directory (followed by a ‘/’) until finally the file name is reached. 
For example, /usr/lem/filex refers to the file filex in the directory lem; lem is itself a subdirectory of usr; usr 
springs directly from the root directory. 


If your current directory has subdirectories, the path names of files therein begin with the name of the sub- 
directory with no prefixed ‘/’. 


A path name may be used anywhere a file name is required. 


Important commands which modify the contents of files are cp(1), mv(1), and rm(1), which respectively 
copy, move (i.e. rename) and remove files. To find out the status of files or directories, use /s(1). See 
mkdir(1) for making directories. 


For a fuller discussion of the file system, see “The UNIX Time-Sharing System,’ by Ken Thompson and 
Dennis Ritchie. It may also be useful to glance through section 2 of this manual, which discusses system 
calls, even if you don’t intend to deal with the system at that level. 


Writing a program. To enter the text of a source program into a UNIX file, use one of the editors, ed(1), 
vi(1), or jim(Q). The principal language processors in UNIX cc(1) for C, f77(1) for Fortran, and awk(1). 
Also available are pascal(1), snobol(1), and more. After the program text has been entered through the edi- 
tor and written on a file, you can give the file to the appropriate language processor as an argument. The 
output of compilers will be left on a file in the current directory named ‘a.out’. (If the output is precious, 
use mv to move it to a less exposed name soon.) 


When you have finally gone through this entire process without provoking any diagnostics, the resulting 
program can be run by giving its name to the shell in response to the shell prompt. 


Your programs can receive arguments from the command line just as system programs do, see exec(2). 


Text processing. Almost all text is entered through the editors. The commands most often used to write 
text on a terminal are: cat, pr, and nroff, all in section 1. 


The cat command simply dumps ASCII text on the terminal, with no processing at all. The pr command 
paginates the text, supplies headings, and has a facility for multi-column output. Nroff is an elaborate text 
formatting program. Used naked, it requires careful forethought, but for ordinary documents it has been 
tamed; see ms(7). 


Troff prepares documents for a phototypesetter; it is very similar to nroff, and often works from exactly the 
same source text. It was used to produce this manual. Its output can drive various devices: phototypeset- 
ters, laser printers, and graphic terminals; see d202(1) and proof(9). 


Status inquiries. “arious commands exist to provide you with useful information. Who(1) prints a list of 
users presently logged in. Date(1) prints the current time and date. Zs(1) will list the files in your directory 
or give summary information about particular files. 


Surprises. Certain commands provide inter-user communication. Even if you do not plan to use them, it 
would be well to learn something about them, because someone else may aim them at you. 


To communicate with another user currently logged in, write(1) is used; mail(1) will leave a message 
whose presence will be announced to another user when he next logs in, if not sooner. Mail(1), sysmon(9), 
and sh(1) provide ways to arrange for continuous monitoring of incoming mail. The write-ups in the man- 
ual also suggest how to respond to messages. 


When you log in, a message-of-the-day may greet you before the first prompt. 


Multiple machines. An Eighth Edition system may have tentacles to many other machines. If you are 
using mux(9), you may download programs for direct execution in your terminal. The file systems of cer- 
tain remote UNIX systems may be accessible through directory ‘/n’. Thus you may change working direc- 
tory to one of these machines, although computing on your behalf is still being done on the machine you 
logged into. You may transmit data among such machines just as within one machine by using cp(1) or I/O 
redirection in the shell. You may also log into a remote machine to do processing there with input and out- 
put passing through the local machine; see dcon(1). Mail extends all over the world; see mail(7). 
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cbt(3) 
bridge(6) 
brk(2) 
cbt(3) 
cbt(1) 
fread(3) 
stdio(3) 
bufld(4) 
setbuf(3) 
bufld(4) 
mknod(8) 
bundle(1) 
button(9.2) 
cbt(3) 
13tol(3) 
swab(3) 
byteyears(1) 
3ec(9.1) 
cc(1) 
cflow(1) 
cpp(8) 
cb(1) 
lint(1) 
xstr(8) 
cyntax(1) 
c56(9.1) 
hypot(3) 
cal(1) 
sky(7) 
de(1) 
matlab(1) 
cal(1) 
calendar(1) 
syscall(2) 
dialout(3) 
ct(1) 

cu(1) 
malloc(3) 
stream(4) 
intro(2) 
deprecated(2) 
can(1) 


candest — 

bean, dean, tcan, xcan — interface to 
termcap — terminal 

bridge — 

canfield, cribbage, fish — 

tolower, toupper — force upper or lower 


Prillter spc sere visa wagceteaeenciaenanteeeaeeeaaetetetesnanene 


programming language .........csceeeeeseeeeeeseeseeeceeeseeeeereeeaees sh, 
TUNCHONIS Fcc sstiies ccdccsssoedcccccccsseusaccdeseassevsordeseussenoucsce fabs, floor, 
cyntax, 


malloc, free, realloc, ialloc, calloc, 
brk, sbrk, break — 

passwd — 

chmod — 

chmod, fchmod — 

chown, fchown — 

chown, chgrp — 

chdir, chroot — 

ching — the book of 

—alter priority of running process by 
pipe — create an interprocess 
ungetc — push 

chrtab — simple 

ispunct, isprint, iscntrl, isascii — 
eqnchar — special 

getc, getchar, fgetc, getw — get 
putc, putchar, fputc, putw — put 
ascii — map of ASCII 

asa — interpret ASA control 
ascii — interpret ASCII 

tr — translate 

vis — show invisible 

snake, worm — display 


dcheck, ncheck — file system consistency 

fsck — file system consistency 

files. tei onus i awlnianiinlen nktae ater uucheck — 
eqn, neqn, 

cyntax, cem — C syntax 


chown, 


cite — process 
isprint, iscntrl, isascii — character 
uucleanup — uucp spool directory 


clri — 

clear — 

UNG UITIES 3263503 oc eescne sss sceventbas esha beeialagedbcreatebolseeeeee! feof, ferror, 
— print and set the date from accurate 

cron — 


fclose, fflush — 
opendir, readdir, telldir, seekdir, 


candest — canon laser printers .........:.cceeceseeseeeeeeeseeeceecseeseeeeeeeseeees 
canfield, cribbage, fish — card games. 
canon laser printers «0.00.0... 


Canon laser-printer spooler .. -can, 


capability data base. 


card games. 
case...... es 
cat — catenate and print... 
catch or ignore signals ... 
catenate and print... eceeeeeeeeeeneeee 

cb, pp — C program beautifier and pretty .. 
cbt — btree utilities... 
CC —C compilers... cess 
cd, wait — shell, the standard command 
ceil — absolute value, floor, Ceiling 0.0... eee eeeeseeeeteeeeeeeeeeeneeee 
cem —C syntax Checker ........eeceeesceeeeeseeseeeeeeeeeseeeaeeaeeeeeeeseeaeees 
cflow — generate C flow graph. 
cfree — main memory allocator 
change Core allocation.........cseceseseeseeeeseeseeeeeeeeeseeeeaeeaeeeeeeeseeaeees 
change login password... 
Clan ge MHOdE:. s.s..c5 ses cease ververics chezsckssereessssisssaledectovaustacisuevedbecaccies 
Change mode:-of fil vscsicc.ssecsecciessaseiecccsacavensceesedavvsvsverserevaveacecscenss 
change owner and group of a file 
Change OWNEL OF QTOUP..... eee eee cess ceeseseeetscsesseetsesseeceesesseeees 
change working or root GireCtOLy......eeeeeeseeeeseeeeeeteeseeeeeeeseeneees 
changes es 
Chan ging: Mice eesenrsrceccneevtendtiaw soencsiesesmertsecea oweeeees renice 
Channels was deiacomv chalice aust niaeneauscsieovenamaeaeeepeintscesety 
character back into input stream . 
Character bitmaps wvecessdcsssececedlevsssecececsabeieeeuedectesseeeesesds vuaabeeteieess 
character classification .0....... cece eseeeeeteeseeeeeeees 
character definitions for eqn.. 
character or word from stream... cece cesses eeeeeeeeeeeseeeteeseeeee 
character or Word On a StreaM oo... esses ee es eteeeeseseeeceeseneee 
character set 
CHATACUEIS ps tiie souvensnssesntnpusneceadesapinannevesiatencecedonoMoneavenn eset ezoes 
Characters :sisssescaiicivescverrassentisecs sited areenigieatedeerritisorstesnaiiaeaees 


CHATACUEIS i eccees os peasccsennonsaseicescesneieccesesiausiietesosnstaastesnneyssreecosvy 
CHase amMesc ede. oiguc crs soeseutes tes pensces cesvna pov aredeatersea oad ences omnngeaeee 
chdir, chroot — change working or root. ws 
CONNEC eos des ca¥occccusassosoncssdeesiateccstanchassnsedh tueres teevsaseauietonsa ieee icheck, 
check and interactive repair... .ceceeseseeseeseeeeseeseeeeseeaeeseeeseeneees 
check uucp directories and permissions 
checkeq — typeset mathematics ..0........ececeeceeeeseeeeeeteeseeeeeeeseeneees 
CHECKED 2 avis tics hiv asteten asi el tert ove alleen ail 
checknews, readnews — read news articles .. 
chgrp — change OWner OF QrOUP ........ceeeeseeceeeeseeseeeeeceseeeeeeeneeaeees 
ching — the book of changes............:ccescsseesceeeneesceseeeceeeeeeeeeeseeees 
chmod — change mode............:000 
chmod, fchmod — change mode of file.. 
chown, chgrp — change owner or group.... 
chown, fchown — change owner and group of. 
chroot — change working or root directory... 
chrtab — simple character bitmaps......... 
cip — picture drawing program........ 
circle, disc, arc, ellipse, eldisc, elarc.. 
citations in a document isi 203 
classification............ ../isalnum, isspace, ispunct, 
clean-up......... 
clear — clear terminal screen.. 
clear i-node...... eee 

clear terminal screen.............. 
clearerr, fileno — stream status . 


+. WWV 


clock daemon... 
close — close a file... 

Close or PUSH a Stra: j.c5.cccccssnseesccces souteseecicessvenaandeeassniocteaceens’s 
closedir — directory OperationSs..........cccceseeseeeeseeeeeeneeaeeseeeeeeneeee 
clri — clear i-node 
CMp — COMpare tWO filOS ...... eee eseeeeeeeseeceeeeseeseeeceecseeeeeeteeeseeees 


candest(7) 
cards(6) 
candest(7) 
can(1) 
termcap(5) 
bridge(6) 
cards(6) 
tolower(3) 
cat(1) 
signal(2) 
cat(1) 
cb(1) 
cbt(1) 
cc(1) 
sh(1) 
floor(3) 
cyntax(1) 
cflow(1) 
malloc(3) 
brk(2) 
passwd(1) 
chmod(1) 
chmod(2) 
chown(2) 
chown(8) 
chdir(2) 
ching(6) 
renice(8) 
pipe(2) 
ungetc(3) 
chrtab(3) 
ctype(3) 
eqnchar(7) 
getc(3) 
putc(3) 
ascii(7) 
asa(1) 
ascii(1) 
tr(1) 
vis(1) 
snake(6) 
chdir(2) 
icheck(8) 
fsck(8) 
uucheck(8) 
eqn(1) 
cyntax(1) 
readnews(1) 
chown(8) 
ching(6) 
chmod(1) 
chmod(2) 
chown(8) 
chown(2) 
chdir(2) 
chrtab(3) 
cip(9.1) 
circle(9.3) 
cite(1) 
ctype(3) 
uucleanup(8) 
clear(1) 
clri(8) 
clear(1) 
ferror(3) 
wwv(1) 
cron(8) 
close(2) 
fclose(3) 
directory(3) 
clri(8) 
cmp(1) 


lines from a file or provide random exit 
screenswap, segment, texture — DaSiC/ 0... seseeeeteeseeeeteeeeees 
LT TUM S NE as cazsxca vaste anessaysaacanesvsrsesaseincnvoealaastewiasvaieiasdeesecbeieass 


garbage — storage allocation with garbage 
make — maintain 

col, 2-6, mc, fold, expand — 

cut, paste — rearrange 

Idpcs — load 

two sorted Tiles viveiscecseessaeeodasidees ceeds easvctetacteaebanaatorass da eeeteucs 
=, ==— redo previous shell 

system — issue a shell 

test — condition 

time — time a 

getarg, large — 

uux — unix to unix 

doctype — guess 

server — run anonymous 

ksh — Korn shell, the not standard 

sh, cd, wait — shell, the standard 

uuxqt — execute remote 

apply — apply a 

intro — introduction to 

at — execute 

Nan Qup svveccsesscisseseecteesoseainetaneasdes nice, nohup — run 
/functions: absolute value, sign, greatest 
comm - select or reject lines 

cmp — 

diff — differential file 

diff3 — 3-way differential file 

idiff — interactive file 

f77 — Fortran 77 

iconc — Icon language translator and 
lisp, liszt, xref — lisp interpreter and 
spitbol — Snobol language 

yacc, eyacc — yet another compiler- 
pret, trace — protocol 

3ar, 3nm, 3size, 3strip, cprs - MAC-32 C 
yacc, eyacc — yet another 

cc, CC —C 

pack, pcat, unpack — 

bkey, breclen, bread, bdelete, bwrite — 
c56 — terminal program with data 

learn — 

whoami — 

test — 

weather — 


config — 
connld — unique stream 
dkdial, dkerror — open a datakit 


icheck, dcheck, ncheck — file system 
fsck — file system 

cons — 

mkfs, mkbitfs, mklost+found — 

doctor, tso — psychiatric 

Is — list 

cursset, cursswitch, getrect123 — mouse 
debug, getproc, getproctab — jerq process 
uustat — uucp status inquiry and job 
lsegment, ltexture, upfront — layer 
stream — stream I/O 

asa — interpret ASA 

init — process 

ioctl, stty, gtty — miscellaneous stream 
atc — air traffic 

mail — address 

ecvt, fevt, gcvt — output 

scanf, fscanf, sscanf — formatted input 


Code, addr, bitblt, point, rectf,.... 
col, 2-6, mc, fold, expand — column 
collect files for distribution... 
collection... 
collections of programs.. 
column alignment 
columns of data 
comet microcode 
comm — select or reject lines common to 
command 
command 
command 
command sae 
command arguments t 
command execution 
command line for formatting a document 
command on another machine.... 
command programming language.. 
command programming language 
command requests 
command to a set of arguments. 
commands......... 
commands at a later time .. 
commands at low priority or immune to 
common divisor, least common multiple,/ 
common to two sorted files... 
compare two files... 
comparison 
comparison 
comparison 
compiler.. 
compiler 
compiler 
compiler.. 
compiler............4. 
compiler and analyzer. 
compiler for 5620 
compiler-compiler.... 
compilers... 
compress and expand files ........ccceceeeseeseeseeeeseeseeeeseeseeseeeeseeaeees 
compressed B-tree subroutines 
compression seditese 
computer aided instruction about UNIX 
computer name 
condition command. 
conditions and forecast by town 
config — configure a Unix kernel 
config — system configuration template 
configure a Unix kernel 
connection 
connection to a remote server 
connld — unique stream connection... 
cons — console interface 
consistency check. ra 
consistency check and interactive repair 
console interface 
construct a file system. 
consultation.......... 
contents of directory 
control 
control 
control......... 
control and graphics 
control calls.......... 
control characters..... 
control initialization 
control operations. 
controller 
conventions and rewrite rules 
conversion 
CONVELSI ODS 55 ccoceadiensa sce seavaaass stessnsdusiasceneassastasteasistaasaccdovasseasestesss 


....1cont, 


../mouse, cursallow, cursinhibit, 
/muxnewwind, newwindow, tolayer, 


/lpoint, lrectf, 


random(1) 
bitblt(9.3) 
column(1) 
bundle(1) 
galloc(3) 
make(1) 
column(1) 
cut(1) 
Idpcs(8) 
comm(1) 
=(1) 
system(3) 
test(1) 
time(1) 
getarg(3) 
uux(1) 
doctype(1) 
server(1) 
ksh(1) 
sh(1) 
uuxqt(8) 
apply(1) 
intro(1) 
at(1) 
nice(1) 
arith(3) 
comm(1) 
cmp(1) 
diff(1) 
diff3(1) 
idiff(1) 
f77(1) 
icont(1) 
lisp(1) 
spitbol(1) 
yacc(1) 
trace(1) 
3cec(9.1) 
yacc(1) 
cc(1) 
pack(1) 
cbt(3) 
c56(9.1) 
learn(1) 
whoami(5) 
test(1) 
weather(7) 
config(8) 
config(5) 
config(8) 
connld(4) 
tdkdial(3) 
connld(4) 
cons(4) 
icheck(8) 
fsck(8) 
cons(4) 
mkfs(8) 
doctor(6) 
Is(1) 
button(9.2) 
newproc(9.2) 
uustat(1) 
newlayer(9.2) 
stream(4) 
asa(1) 
init(8) 
ioctl(2) 
atc(6) 
mail(7) 
ecvt(3) 
scanf(3) 


units — 

dd — 

number — 

ranlib — 

atof, atoi, atol — 

TLE SETS: sere ecess:daeceacieaidertisnavaniscasessaverseasestaestisicieaee 13tol, Itol3 — 
localtime, gmtime, asctime, timezone — 
mugs — 

bed, ppt — 

fortune — 

cp, rep — 

push, pull — datakit remote file 

track — selective remote file 

uulog, uuname — unix to unix remote file 
dd — convert and 

cpio — 

ropy — remote file 

blitblt — make hard 


brk, sbrk, break — change 

savecore — save a 

coreid — identify source of 

Math PUNCHONS ve. Pin ssesicyecdeccdoelsedsseeesdesaedendec cnt voeseuestayaseeeses 
trigonometric FUNCTIONS. ........ eee eseeseeeeteeseeceteeseeseeeeaeeaeenees sin, 
sinh, 

we — word 

sum — sum and 

mcs — macros for formatting 


3cc, 3as, 3ar, 3nm, 3size, 3strip, 
iostat, load, dkstat — report I/O and 


pipe — 

windows, jps, reshape — 
umask — set file 
canfield, 


pxref — pascal printer, profiler, and 


timezone — convert date and time tO/.........cceceseeeeseeteeseeeseeees 
A CSLIMIN ANY soe asitssces ssveceaat cdaleveatcncccesavateperaasedecedeonts ttyname, 


getwd, getcwd — get 


cursswitch, getrect]23/ 00... .ieeeeeseeeneeee button123, mouse, 
CUPS OF MOON 33 rcssiasecseticcssvencened fasask gosh ssagadinves fd denaseaeaesticaatnes 
getrect123/... ..button123, mouse, cursallow, 
curses — screen functions with ‘optimal’ 

button123, mouse, cursallow, cursinhibit, 

PUTED Ss esicescvsroestexs pray tedtyaecacenesiexs Sautene eae ae eRe a Cae TE an teers 


twid — 

cron — clock 

Ipd — line printer 

d202, 

cut, paste — rearrange columns of 

prof — display profile 

ttys — terminal initialization 

termcap — terminal capability 

c56 — terminal program with 

null — 

types — primitive system 

Drect, Jrect — basic jerq graphics 

join — relational 

DBunlock, DBsync, DBapp, DBins, DBcopy — 
fetch, store, delete, firstkey, nextkey — 


-6- 


CONVELSION PLOQTAM ....... eee eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeees 
convert and copy a file... 
convert Arabic numerals to English... 
convert archives to random libraries .. 
convert ASCII to numbers............+ 
convert between 3-byte integers and long. 
convert date and time to ASCII............. 
convert gray-scale pictures into icons 
convert to antique media..............4. 

COOKIES 00... eeeeeeeteeeeeees 


.ctime, 


copy for arpa internet 
copy of screen image ........... ee 
core — format of memory image file 00.0.0... ec eeseeeeeeseeeeeeeteeseees 
COPE ANOCAN ON cis0ie. ves cotensstesstessotovetiag dvs ants dadednatowyees covsbberbecaeasors 
core dump of the operating system. 
COPEAMAG Ciaticeiscs teaiecnesviaierieisectesiedcieptentviasigieiestaaistaeisuaeblsasans 


count blocks in a file... 
COVER SHECES ecco scan testia tieatemerm ir ianiea tee smateatens 
CPslC p= COPY. inieces stun niente avi ce annoy 
cpio — copy file archives in and out 
cpio — format of CPpi0 ALChive .........seeeeseesceseteeeesceeeeeseeeeteeseees 
cpp — C language preprocessor ..........ccscesseseeseteececeeeeeeseeeeeeeseeees 
cprs —- MAC-32 C compiler for 5620. 
CPU statisticss.issiceccscussteetsscasseterouahsasinesccnesieereccaai ean 
crabs — graphical marine adventure gaMe..........:eceeceseeseeeteeeeeees 
creat — create a new file : 
create an interprocess Channel..........:.cccscseeseecsseeseeeeteeseeeeeeeeeeneees 
create and initialize WINdOWS.........cceeceseseeceeeeseeseeeeeeaeeseeeseeaeees 
creation mode mask 
cribbage, fish — card GaMes.........ccecseseseeseeseeeeseeseeeeeeaeeeeeeeseeneees 
CON: = CloCk: CACM ON se. -cevevcessncsas cuyercceo ses svuiendeacet ous vnceneoueheetendvsnsd 
cross-reference lister 
crypt, encrypt, decrypt — encode/decode........ccseseeseeseeeteeteeees 
crypt, setkey, encrypt — DES encryption... eeeseeseeeeeeeeeees 
ct — call terminal (and start a session)... 
ctime, localtime, gmtime, asctiMe,.........ccceceseesceseeeeteeceeeeteeseeees 
cttyname, isatty, ttyslot — find name Of 0... eceeseeseeeeeeeneeeeeee 
cu — call Unix 
current directory... 
cursallow, cursinhibit, CUrSSCt,.........00.ceccccessseeeesscesessseceesseseeens 
curses — screen functions with ‘optimal’... 
cursinhibit, cursset, cursswitch, ......... 
CULSOF MOTION ....... ee eeeeeeeeeeeeeeeeeeeneeee 

cursset, cursswitch, getrect!23 — mouse/.. 
cut, paste — rearrange columns of data.. 
cyntax, cem — C syntax checket......... 
d202, daps, dcan, tc — phototypesetter .. 
dabble in oils. 
daemon... 
daemon... 
daps, dcan, tc — phototypesetter filters.. 


data base..... 

data compression.. 
data sink. 
data types ¥ 
ata ty Pes ive ccccssy sus closcennug auiccessenane ceecces /Pt, Rect, Rpt, display, 
database: Operator s.cecc2. ac iveeeavatarnaouceiesn ened etna teense 
database subroutines .. 
database subroutines 


units(7) 
dd(1) 
number(1) 
ranlib(1) 
atof(3) 
13tol(3) 
ctime(3) 
mugs(9.1) 
bced(6) 
fortune(6) 
cp(1) 
push(1) 
track(1) 
uucp(1) 
dd(1) 
cpio(1) 
ropy(1) 
blitblt(9.1) 
core(5) 
brk(2) 
savecore(8) 
coreid(1) 
cos(9.3) 
sin(3) 
sinh(3) 
we(1) 
sum(1) 
mcs(7) 
cp(1) 
cpio(1) 
cpio(5) 
cpp(8) 
3cc(9.1) 
iostat(1) 
crabs(9.6) 
creat(2) 
pipe(2) 
windows(9.1) 
umask(2) 
cards(6) 
cron(8) 
pxp(1) 
crypt(1) 
crypt(3) 
ct(1) 
ctime(3) 
ttyname(3) 
cu(1) 
getwd(3) 
button(9.2) 
curses(3) 
button(9.2) 
curses(3) 
button(9.2) 
cut(1) 
cyntax(1) 
d202(1) 
twid(9.6) 
cron(8) 
Ipd(8) 
d202(1) 
cut(1) 
prof(1) 
ttys(5) 
termcap(5) 
c56(9.1) 
null(4) 
types(5) 
types(9.5) 
join(1) 
DB(3) 
dbm(3) 


dkdial, dkerror — open a 

dk — 

push, pull — 

dkmgrnak, dkfilename — establish 
date — print and set the 

touch — set file modification 


time, ftime — get 

gmtime, asctime, timezone — convert 

wwv — print and set the 

newer — test file modification 

DBkey0, DBkeyn, DBlock, DBunlock, DBsync, 

DBS yf sis sccstinia dee DBopen, DBclose, DBget, DBput, 
nextkey — database subroutines........ “3 
DBkey0, DBkeyn, DBlock, DBunlock, DBsync,/.............. 


d202, daps, 
laser-printer SpOOLeT..........ceceeeseeseeeeeeeeeseteeseeeeeeenee can, bean, 
CHECK cstict cia Noted Gevesvcaseud itasaasrncdi caveseacasas hedbetianiseebien? icheck, 


/newproc, muxnewwind, newwindow, tolayer, 
ra— 

crypt, encrypt, decrypt — encode/ 

eqnchar — special character 


—jerq text and font operations... eeececeeeeseereeeeeeeeees string, 
GUDOUUIIES  cavovessiesccatencaieataten cata teteagenes dbminit, fetch, store, 

tail — 
Isegment, Itexture, upfront —/...... ee eeeeeeeeeereeeeneeee newlayer, 


worms, hanoi, rain — silly 
mesg — permit or 


crypt, setkey, encrypt — 

dup, dup2 — duplicate an open file 
setfsent, endfsent — get file system 
fd, stdin, stdout, stderr, tty — file 
de - 

matlab — interactive matrix 

drum — paging 

finddev — find processes using a 
swapon — specify paging/swapping 


dmesg — system 


ACEI OM ANTES 555 sis Piss atassconcseaiahsaesk vosadtaseseusciadescq servo asastasecsninteita cee 
wwb, style, 

dict — look up words in English 

COMPALISON sy ocsieaconuecavstaaare vinta ew end ecveias deevaeteaeg ene soenaees 
diff — 

diff3 — 3-way 

map — 


awk — pattern- 

dir — format of 

mv — move or rename files and 
uucheck — check uucp 

chdir, chroot — change working or root 
getwd, getcwd — get current 

1s — list contents of 

mkdir — make a 

mkdir, rmdir — make or remove a 
where — print machine name and working 
rmdir — unlink 

uucleanup — uucp spool 

dired — 

unlink — remove 

readdir, telldir, seekdir, closedir — 
mknod — make a 


basename, 


datakit connection to a remote STVeT.........ccecceceesssseceeeteeteeseeeees 
Datakit interface... ccc eeeeceeeeeee 

datakit remote file copy.. 
datakit server........... 
date... 
date... 
date — print and set the date... 


..dkmgr, dkmgrack, 


date and time to ASCII.. 
date from accurate clock 
dates .... 
DBapp, DBins, DBcopy — database/............ es ; 
DBdel, DBkey0, DBkeyn, DBlock, DBunlock, . 
dbminit, fetch, store, delete, firstkey,.... 
DBopen, DBclose, DBget, DBput, DBdel,.. 
de.= desk. calculatori.:....ivsceccecscsssredectscsdeavercelesctevescetseusvsecoctevetes 
dean, tc — phototypesetter filters 0.0.0... eset eceeeseeeceeeneeeeeeeeeeseeneeee 
dcan, tcan, xcan — interface to Canon... 
dcheck, ncheck — file system Consistency .........c:eceseseeeeeeseeeeees 
dcon, ndcon, rx, rogin, rsh — remote 


definitions: for 6qitwicin seve ciereceanenctiaiiene merece 
defont, strwidth, infont, outfont, getfont....... ee eeeeeeeeeseeeeeee 
delete, firstkey, nextkey — database... 
deliver the last part of a file... elie eseeeteeteeseeeeeeaeeeeeeeseeaeees 
dellayer, Ibitblt, Ipoint, Irectf, 0... eeseeeeeeseeceeecneeeeeeeeeeaeeneees 
demo — graphic demonstrations and games . 


Ceny* Messages :is.siseecceisisecte dies ussueiercscetaseesev beni seve soveecennemane tenses 
deroff — remove formatting requests.. : 
DES setiery ptiOn sis veccetsesssseeces aaasseenscdcansvetengarteisnadeczcentesneeceiaas 
CESCLIPlOL 2.261 iedseeseseusetesin iets terecssaatreneaei hase sinus ationstageeeeies es 
descriptor file entry. ../getfsfile, 
descriptor files::, asi. ciecrangendsrareeieeasid tase cceae eens 
desk Calculators. sissssssctaascssohszsssgeeucevestestssiessorgessssseessesenasonsaees 
desk calculator . 
CE VACE is iraashets lasasussegesesta itive. cusetaccedssouesdde vious unmuasiccssainavetesesests 


AE isk fre cases ites ss sve sos ste ssnveustaiasss ses sesuseasigecssastehsssvestsasssrazveses 
Aiagnostic MESSAGES ......eeeeeecceceeeeseeeceececseeeeeeeseeseeeaeeaeeeeeesseeaeees 
dialout — place call on ACU 
dict — look up words in English ..........cccesceceseeseeceeeeseeeeeeeeeeeeeees 
diction, punct — writers workbench...........c:ecseeeseeseteeteeseeeeeeneeee 
dictionaries... eee eee eee : 
diff — differential file comparison ..........cecceceseseeseeeeteeeeeeeteeeeeees 
diff3 — 3-way differential file... eects ceesereeeeeeees 
differential file comparison... 
differential file comparison... 
digitized map formats ....... 
dir — format of directories «0.0... 
directed scanning and processing language . 
CLS CUOTICS: sass sesessasssesshivcsazssssvaeesenssbosties 
directories............. 
directories and permissions file... 
CULE CLOLY iis dass cccvsessestastevcasiasis 
directory. 
directory. 
directory. 
directory. 
directory. 
directory........... 
directory clean-up 
directory editor. 
directory entry...... sodeveicus 
directory operations .... opendir, 
directory of-aspeécial files scsicccracccaaseiasaeanicomeaiiaen 
dired — directory editor.......... 
dirname — strip filename affixes...........cececeesseeseeeeneeeeeeeeeeeeeneees 


.. pwd, 


tdkdial(3) 
dk(4) 
push(1) 
dkmer(3) 
date(1) 
touch(1) 
date(1) 
time(2) 
ctime(3) 
wwv(1) 
newer(1) 
DB(3) 
DB(3) 
dbm(3) 
DB(3) 
de(1) 
d202(1) 
can(1) 
icheck(8) 
dcon(1) 
dd(1) 
newproc(9.2) 
ra(4) 
crypt(1) 
eqnchar(7) 
string(9.3) 
dbm(3) 
tail(1) 
newlayer(9.2) 
demo(9.6) 
worms(6) 
mesg(1) 
deroff(1) 
crypt(3) 
dup(2) 
getfsent(3) 
fd(4) 

de(1) 
matlab(1) 
drum(4) 
finddev(8) 
swapon(8) 
df(1) 
dmesg(8) 
dialout(3) 
dict(7) 
wwb(1) 
dict(7) 
diff(1) 
diff3(1) 
diff(1) 
diff3(1) 
map(5) 
dir(5) 
awk(1) 
dir(5) 
mv(1) 
uucheck(8) 
chdir(2) 
getwd(3) 
Is(1) 
mkdir(1) 
mkdir(2) 
pwd(1) 
rmdir(8) 
uucleanup(8) 
dired(1) 
unlink(2) 
directory(3) 
mknod(2) 
dired(1) 
basename(1) 


circle drawing functions for jerq.........ceseeeseeseeeeneeeeeeee circle, 
buf_ld — buffering line 

mesg, rmesg — message line 

tk — RK11/RKO7 

df — 

du — summarize 

rarct — replace bad blocks on MSCP 

ra — DEC MSCP 

mount, umount — mount and 

snake, worm — 

/Rectangle, Bitmap, Texture, Pt, Rect, Rpt, 

prof — 

sysmon, vismon — 

hypot, cabs — euclidean 

inspkg, seal, unseal — automatic software 

bundle — collect files for 

ship — automatic software 

ptinrect, raddp, rsubp,/ 0.0... eceeseeseeeeeeereeeeeeeee add, sub, mul, 
/absolute value, sign, greatest common 


CONNECTION tO a FEMOTE SCTVET.......ccecescescesseseeeteeteeeseeeeseeeseeaes 
dkmgr, dkmgrack, dkmgrnak, 
iostat, load, 


SCTIPt.. csievcee ncn nce mente ena am eee 


formatting a dOCUMENL......... cc eeeeeceecteeeeseeeeseeseeeeseeseeeeeeeaeeees 
cite — process citations in a 

— guess command line for formatting a 
docgen — generate a 

find and insert literature references in 
monk, monksample — typeset 

pen — 

graph — 

map — 

paint — 

arc, ellipse, eldisc, elarc — circle 

grap — pic preprocessor for 

ideal — troff preprocessor for 

pic — troff preprocessor for 

cip — picture 

/Bitmap, Texture, Pt, Rect, Rpt, display, 
arithmetic — 

rk — RK11/RKO7 disk 


od — octal 

savecore — save a core 

adventure, zork, aardvark, rogue, wump — 

AOS CHIPTOR sere ce Ao ieencesedeeveauscacss toecvexcendecnpraeassectvexeecatccevonsenstenss 


end, etext, 

dired — directory 
ed — text 

icon — icon 


jf — font 

jim, jim.recover — text 

Id — link 

ped, tped — picture 

sed — stream 

ex, vi — text 

a.out — assembler and link 


... QTep, 
circle, disc, arc, ellipse, eldisc, 
crypt, encrypt, decrypt — 
crypt, setkey, 

crypt, 

crypt, setkey, encrypt - DES 
makekey — generate 
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disc, arc, ellipse, eldisc, lar —...... ec eeeeseeeeeeseeseeeeneeseeeeeeeseeneeee 
discipline... eects 

discipline modules .. 
disk driver ..... 

disk free.. 
disk usage... 


ie .rarepl, 
disks (RA60, RA80, RA81).. 
dismount file system......... 
display chase games............04 

display, Drect, Jrect — basic jerq/ 
display profile data... 

display system statistics . 
distance... 
distribution. 
CiStEIDULIONS soccsessiceeauecoesoeoe chee cibenedtesoussvecoleotspubeauecneupecbecneestes 
distribution 
div, eqpt, eqrect, inset, muldiv,... ashi 

divisor, least common multiple, minimum,/ 
dk — Datakit interface... eee eee eseesceeeseeecseeeteesesseeeaeaes 
dkdial, dkerror — open a datakit ...... 
dkfilename — establish datakit server... eee eects 
dkstat — report I/O and CPU statistics 
dmesg — system diagnostic messages. 
docgen — generate a document ffOM €.......... ec eeeseeeeeeseeeteeteeseeees 
doctor, tso — psychiatric consultation...........ccscseeeeeseeeeeeteeeeees 
doctype — guess command line for.. 
AGCUMECTI Eines crccsecsia vender om sineeresastoesvesteresesowesvetes dete adciseswoaieeceseees 
COCUM CHE srececisiavsvacterdbabetareedece anes tccccts ea deveretasvenscerts doctype 
document from a script .. 
Cocumentts........ eee eects 


doodle anywhere on the screen ; 
draw: a: oraphisss..siscecteccasiyealecassetecnanieeens i uiienaenpeeicions 
draw maps ON VariOuSs ProjectiOnS..........cceeeeeseeeeeeneeteeeeeeeteeneees 
draw pictures in a layer ae 
drawing functions for jerq........ececeseeeseeseeseeeeneeeeeeeee circle, disc, 
drawing graphs 
drawing pictures... 
LAWNS PICKUPS ssi ceccseacayaveecccasespeveucessscustauscceusevpeasatscasvaseeeceee és 
ALAWIN SE PrOSTAM: oe ccc seevetevses os paniaceapteaategiersrindietceromnngdate 
Drect, Jrect — basic jerq graphics data/.. 
ei im number facts s. iaiss seacssccesctsisasg tesvossseseeierveiscsseaees sesertzsazeeses 


dump of the operating system.. 
dungeon-exploration SaMes ..........ceceeesceeeeeeeeseeeeeeeeeseeeeeeaeeeees 
dup, dup2 — duplicate an open file... cee eeeeseeseeeeseeseeeeeeeeeees 
echo — echo arguments... 
ecvt, fevt, gcvt — output conversion 
ed — text editor 0. 
edata — last locations in program. 
editor... 
editor... 
editor... 
editor... 
editor... 
editor... 
editor... 
editor... 
editor...... 

editor OUtPUL oe ee eeeeeeeeeeeeees 
efl — extended Fortran language.. 
egrep, fgrep — search a file for a...... 
elarc — circle drawing functions for jerq 
encode/decode......ceeeeeeeseeeeeeee ‘ 
encrypt — DES encryption........eececeeeeseeseeseeeeseeseeeeeeaeeeeeeeeeeneees 
encrypt, decrypt — encode/decode.........ceseseeesseeseeseteeteeeeeeeneeseeee 
encryption 
encryption key 


circle(9.3) 
bufld(4) 
mesg(4) 
tk(4) 

df(1) 
du(1) 
rarepl(8) 
ra(4) 
mount(8) 
snake(6) 
types(9.5) 
prof(1) 
sysmon(9.1) 
hypot(3) 
asd(8) 
bundle(1) 
ship(1) 
add(9.3) 
arith(3) 
dk(4) 
tdkdial(3) 
dkmer(3) 
iostat(1) 
dmesg(8) 
docgen(1) 
doctor(6) 
doctype(1) 
cite(1) 
doctype(1) 
docgen(1) 
refer(1) 
monk(1) 
pen(9.6) 
graph(1) 
map(7) 
paint(9.1) 
circle(9.3) 
grap(1) 
ideal(1) 
pic(1) 
cip(9.1) 
types(9.5) 
arithmetic(6) 
rk(4) 
drum(4) 
du(1) 
od(1) 
savecore(8) 
adventure(6) 
dup(2) 
echo(1) 
ecvt(3) 
ed(1) 
end(3) 
dired(1) 
ed(1) 
icon(9.1) 
jf9.1) 
jim(9.1) 
Id(1) 
ped(9.1) 
sed(1) 
vi(1) 

a(5) 

efl(1) 
grep(1) 
circle(9.3) 
crypt(1) 
crypt(3) 
crypt(1) 
crypt(3) 
makekey(8) 


PEO SEAN 55 facaes conte tes have dtadde santa studs tues vondesvas cctessatgens stadt tee 
getfsent, getfsspec, getfsfile, setfsent, 
getgrent, getgrgid, getgrnam, setgrent, 
/getpwent, getpwuid, getpwnam, setpwent, 
number — convert Arabic numerals to 

dict — look up words in 

xsend, xget, 

nlist — get 

— get file system descriptor file 

setgrent, endgrent — get group file 
endpwent, pwdecode — get password file 
unlink — remove directory 

execve, execlp, execvp, exec, exece, 


getenv — value for 
sky — calculate 
— special character definitions for 


for eqn 


erf, erfc — 

perror, sys errlist, sys_nerr— system 

ermo — introduction to system calls and 
spell — find spelling 

dkmgr, dkmgrack, dkmgrnak, dkfilename — 
vec, move, 

end, 

hypot, cabs — 

expr — 


/execv, execle, execve, execlp, execvp, 


exec, exece, environ — execute a/ 
realtime, sendchar, sendnchars, kill, 


sample lines from a file or provide random 

logarithm, power, SQUaTE FOOL... eee eseeseeeeeeeeeeeeeaeeeeeeeneeneee® 
col, 2-6, mc, fold, 

pack, pcat, unpack — compress and 

zork, aardvark, rogue, wump — dungeon- 

Idexp, modf — split into mantissa and 

exp, log, log10, pow, sqrt — 

EXPLESSIOM sis cs ecssasasascevtasasnsastsvcaszd sve suessaatensacctesatieaaaceceseveeusais 
re_comp, re_exec — regular 

regexec, regsub, regerror — regular 

efl — 

yacc, 


floor, ceiling FUNCTIONS «0.0... eee teeeeeeteeseeeeeeeseeeeneeaeeeeeeseeneees 


faced — network 

face — show 

factor, Ifactor, qfactor, primes — 
true, 

abort — generate a 

chmod, 

chown, 


descriptor filesy.. ss iccccceesssencescabisserevedctuavenencoscuavsnenseredaessvederents 


status inquiries 


database subroutines ..... ...dbminit, 
fclose, 

SHEA sisissdissisiseerssiaveeecetelanutneit aiseaieses getc, getchar, 
gets, 

grep, egrep, 


access — determine accessibility of 
acct — execution accounting 
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end, etext, edata — last locations in. 
endfsent — get file system descriptor/ 
endgrent — get group file entry 
endpwent, pwdecode — get password file/.. 
English.... ae 
English dictionaries.. 
enroll — secret mail 


./getfsfile, setfsent, endfsent 
getgrent, getgrgid, getgrnam, 
/getpwuid, getpwnam, setpwent, 


eqn, neqn, checkeq — typeset mathematics.. 
eqnchar — special character definitions .... 
eqpt, eqrect, inset, muldiv, ptinrect, 
erf, erfc — error function 
erro — introduction to system calls and.. 
error function .... 
GrTOr MESSAGES Hii Oliv andeeclpanseieli cascades aecsalicnauetedeeey 
error numbers 


establish datakit server... 
etc. — graphics interface .... 
etext, edata — last locations in program 
euclidean distance 
evaluate arguments as an expression. 
ex, vi — text editor 
exec, exece, environ — execute a file 
execute commands at a later time 
execute remote command requests... 
execv, execle, execve, execlp, execvp, . 
exit — jerq I/O requests...... 
exit — terminate process. 
exit code 
exp, log, log10, pow, sqrt — exponential, . 
expand — column alignment.. 
expand files.............. 
exploration games ... 
exponent 
exponential, logarithm, power, square root. 
expr — evaluate arguments as an 
expression handler ... 
expression handler... 
extended Fortran language preprocessor. 
eyacc — yet another compiler-compiler. 
f77 — Fortran 77 compiler 
fabs, floor, ceil — absolute value, 
face — show faces on jerq 
face server 
faces on jerq 
factor a number, generate large primes 
false — provide truth values... 


fchmod — change mode of file........... 

fchown — change owner and group of a file 
fclose, fflush — close or flush a stream 
fevt, gcvt — output conversion 
fd, stdin, stdout, stderr, tty — file. 
fdopen — open a stream..... 
feof, ferror, clearerr, fileno — stream. 
fetch, store, delete, firstkey, nextkey — 
fflush — close or flush a stream 
fgetc, getw — get character or word from. 
fgets — get a string from a stream 


end(3) 
getfsent(3) 
getgrent(3) 
getpwent(3) 
number(1) 
dict(7) 
xsend(1) 
nlist(3) 
getfsent(3) 
getgrent(3) 
getpwent(3) 
unlink(2) 
exec(2) 
environ(5) 
getenv(3) 
sky(7) 
eqnchar(7) 
eqn(1) 
eqnchar(7) 
add(9.3) 
erf(3) 
intro(2) 
erf(3) 
perror(3) 
intro(2) 
spell(1) 
dkmer(3) 
plot(3) 
end(3) 
hypot(3) 
expr(1) 
vi(1) 
exec(2) 
at(1) 
uuxqt(8) 
exec(2) 
request(9.2) 
exit(2) 
random(1) 
exp(3) 
column(1) 
pack(1) 
adventure(6) 
frexp(3) 
exp(3) 
expr(1) 
regex(3) 
regexp(3) 
efl(1) 
yacc(1) 
f77(1) 
floor(3) 
face(9.1) 
faced(9.5) 
face(9.1) 
factor(1) 
true(1) 
abort(3) 
chmod(2) 
chown(2) 
fclose(3) 
ecvt(3) 
fd(4) 
fopen(3) 
ferror(3) 
dbm(3) 
fclose(3) 
getc(3) 
gets(3) 
grep(1) 
access(2) 
acct(5) 


bitfile — format of bitmap 

chmod, fchmod — change mode of 
fchown — change owner and group of a 
close — close a 

core — format of memory image 

creat — create a new 

dd — convert and copy a 

eXxecvp, exec, exece, environ — execute a 
group — group 

link, symlink, readlink — link to a 
mknod — make a directory or a special 
mknod — build special 

passwd — password 

pr — print 

ptopen — find and open a pseudo-terminal 
read — read from 

size — size of an object 

sum — sum and count blocks in a 

tail — deliver the last part of a 

uniq — report repeated lines in a 

— check uucp directories and permissions 
write — write ona 


cpio — copy 

diff — differential 

diff3 — 3-way differential 

idiff — interactive 

push, pull — datakit remote 

track — selective remote 

uucp, uulog, uuname — unix to unix remote 
ropy — remote 

umask — set 

dup, dup2 — duplicate an open 

fd, stdin, stdout, stderr, tty — 

endfsent — get file system descriptor 
getgrnam, setgrent, endgrent — get group 
endpwent, pwdecode — get password 
grep, egrep, fgrep — search a 

newsrc — information 

ar — archive (library) 

split, fsplit — split a 

touch — set 

newer — test 

mktemp, tmpnam — make a unique 
random — sample lines from a 

byteyears — time-space product for 

stat, Istat, fstat — get 

gmount — mount or remove non-standard 
mkfs, mkbitfs, mklost+found — construct a 
mount, umount — mount or remove 
mount, umount — mount and dismount 
netfs — network 

/proc — process 

icheck, dcheck, ncheck — 

eres fsck — 
/getfsfile, setfsent, endfsent — get 
quot — summarize 

mtab — mounted 

filsys, flblk, ino — format of 

utime — set 

uucico — 

uusched — uucp 

ftw — 

file — determine 

basename, dirname — strip 

feof, ferror, clearerr, 

arff—read RT11 

cmp — compare two 

or reject lines common to two sorted 
config — system configuration template 
stdout, stderr, tty — file descriptor 
find — find 


interactive repair 


file — determine file type 
file archives in and out... 
FILS COMMPALIS OM 5 og 2a cee se eveteecen sep censae cnepen ateeealeerd sen seiceomaumngeedeeues 
FilE COMPALIS OD, .svcacesesceessveuseescassvecaccecseusvexeseoiedaaveizeeescxesspeeeetecenss 
file comparison. ; 
FS COPY’ w.siccscsctensoeateens se aaegtis tot pete bec ss ahh eegieua sien teteetoaenadenes 
PS 2COPY. vee cedeesceissls raves st raicusccesvaneatenneenn iat ncaeanniaeectonin tena: 
file copy 
file copy for arpa internet... eceeeseseeseeeeeeeseeseeeeseeaeeeeeeeseeneees 
file creation mode Mask... eee eee este eseeeeeeseaeeeteesenseeees 
file descriptor 
file descriptor files scsecciieysececcessseeceisauvseesetecvueiietsedensvereiceents 
FS SU Y se svesssccscseacizseaveesisieesttiteaeeas /getfsfile, setfsent, 
file entry.. getgrent, getergid, 
AE CNUY, cessed sceccsaneeeverccceees /getpwuid, getpwnam, setpwent, 
file for a pattern 
file for readnews .. 
File FORM abi ses fo cass secesessiveenescuseeccess ou caguises daviaasacesveneeeteneneots 
FIIS INLO PIOCES 5 o4s cre gedecs seeeatenceaees eetiaceeger ad alae ete oma 
file modification date... 
file modification dates... eee cesses cseseeeeeeseeesensenseees 
FINE NAME se oe, te, casins soviees sovsntiten cudeesceeeie oa nestencugten neteabrenniiononoseutendeades 
file or provide random exit code. 
FILE TESIMENCY.« cco cccdeces see vessadas iscnscasivscasvansaniasteseessistaasasei sea aasesterss 
FG: Status eeiees ea ssecteel esi sedcecca beamed usa ieee dead 
file system.. 
FIG SYStEM wees. s shades eae od Hale one 
FILS SYStOM sepa c ce esccsaancekeasevcaecccecsavsegeusesesa+desaiesescousentarectsiavaseeceteurs 
file system.. 
file system.. 
file system..... 
file system consistency check..... 
file system consistency check and .. 
file system descriptor file entry... 
file system ownership ........... 
file system table... 
file system volume.. 
FILE LIMES So censuses eee 
file transport program for the uucp system.. 
file transport schedulet...............0 

file tree walk ........... 
file type...... 
filename affixes... 

fileno — stream status inquiries. 
files... 
files... m 


PROSE, ceases caatice nt covqeanccveviyenrsuceasavesbesagedsatecdeuntensveves comm — select 


bitfile(9.5) 
chmod(2) 
chown(2) 
close(2) 
core(5) 
creat(2) 
dd(1) 
exec(2) 
group(5) 
link(2) 
mknod(2) 
mknod(8) 
passwd(5) 
pr(1) 
ptopen(3) 
read(2) 
size(1) 
sum(1) 
tail(1) 
uniq(1) 
uucheck(8) 
write(2) 
file(1) 
cpio(1) 
diff(1) 
diff3(1) 
idiff(1) 
push(1) 
track(1) 
uucp(1) 
ropy(1) 
umask(2) 
dup(2) 
fd(4) 
getfsent(3) 
getgrent(3) 
getpwent(3) 
grep(1) 
newsrc(5) 
ar(5) 
split(1) 
touch(1) 
newer(1) 
mktemp(3) 
random(1) 
byteyears(1) 
stat(2) 
gmount(2) 
mkfs(8) 
mount(2) 
mount(8) 
netfs(8) 
proc(4) 
icheck(8) 
fsck(8) 
getfsent(3) 
quot(8) 
mtab(5) 
filsys(5) 
utime(2) 
uucico(8) 
uusched(8) 
ftw(3) 
file(1) 
basename(1) 
ferror(3) 
arff(8) 
cmp(1) 
comm(1) 
config(5) 
fd(4) 
find(1) 


— USENET network news article, utility 
pack, pcat, unpack — compress and expand 
pt — interprocess I/O junctor 

rm, rmdir — remove (unlink) 

sort — sort and/or merge 

mv — move or rename 

bundle — collect 

fstab — static information about the 

SyStem VOM) Jo.scesctees ties peteriee icra na tenes trie reemeeene 
d202, daps, dcan, tc — phototypesetter 

plot — graphics 


GOCUMENES ..... eee eee ceeessceeessseeeee refer, lookbib, pubindex — 
ptopen — 

find — 

look — 

ttyname, cttyname, isatty, ttyslot — 

finddev — 

spell — 


blitmap — map plots and path 
dbminit, fetch, store, delete, 


canfield, cribbage, 

filsys, 

hoc — interactive 

CeTING FUNCTIONS... ee eeeeeceeeneeeeeeeeeeseeeeeeeaeeseeeeeeeneeeeeeees fabs, 


cflow — generate C 
fclose, fflush — close or 
col, 2-6, mc, 


jf- 

font — jerq 

infont, outfont, getfont — jerq text and 
font — typesetter 


tolower, toupper — 
weather — conditions and 


ar — archive (library) file 
bitfile — 


filsys, flblk, ino — 

core — 

tbl — 

map — digitized map 

scanf, fscanf, sscanf — 

printf, fprintf, sprintf — print 
doctype — guess command line for 
troff, nroff — text 

mcs — macros for 

ms — macros for 

deroff — remove 

getarg, iargc — command arguments to 
port — mathematical library for 
{77 - 

ratfor — rational 

efl — extended 

struct — structure 


mkfs, mkbitfs, mklost+ 

printf, 

SUC AMM cis scssvessecsessessessasddevequeanesicgianseasiadeeeeeee te putc, putchar, 
puts, 

PONETALOL sac. eecacecas save deeak ae apaiercvonuevnsctcusenvenavente rand, lrand, 


allOCate MEM OLY <..s35. ced Sioa ceccsssoenccecestnie ae eceraetccss alloc, 
main memory allocator.........cceeceeeseeceeeeeeeseeeeteeseeneeee malloc, 


=f] = 


S sacncescscscnsesescscncesesanescesesessnsescccssnsscascsasescscessscsscessseeeceses news 


files for distribution. 
filesystems .... 
filsys, flblk, ino — format of file 
filters 
filters... 
find — find files. 
find and insert literature references in 
find and open a pseudo-terminal file.. 
FIN FICS ss veccessoesssuszccecaveveteesss aveaes 


find name of a terminal... cece eee ee cscs eeeecaeeteeseneeees 
find processes using a device... 
find spelling errors 
finddev — find processes using a deVICC........seseeceeeeseeeeeeteeeees 
finding on a jerq 
firstkey, nextkey — database subroutines............ceceseseeeeeeneeeeeee 
fish'— ‘card: SAME ycccstiesavecsicssassvees ceceseuavens ceocedavverseetserevsveacececenss 
flblk, ino — format of file system volume.. 
floating point language 0.0... cceeseeseeeeseeeeeeeeeseeseeeaeeaeeeeeeseeaeees 
floor, ceil — absolute value, flOOr, .........eee cece eeeesceeeesseeeeseseeees 
flow graph 
flush a stream... 
fold, expand — column alignment... cceseeeceeeeseeteeeeeeeneeneeee 
font — jerq font layouts 
font — typesetter fONtS...... eee eeeeeeeeeteeeeseeeeneesceeceecaeeeeeeteeseeees 
FONE EGU este dcse ret cosa yeiveeve lose teeedesuectscotensatbusteveovosoeiateuesenes 
font layouts ... ae 
font Operations .........ceceeeeeseeeteeeeeeeeeeeee string, defont, strwidth, 
PONS seeesriacisss sei ainenrgeniscensuieenas 
fopen, freopen, fdopen — open a stream 
force upper Or lOWer CASO... eeeeesceseeeeeeseeeeeeeseeseeeeaeeaeeseeeeaeeneees 
forecast by. to wis: si cseesicdieidsteccsaaceascaxcoveisiansciecaseusasceneiovasvoaceaeaees 
fork — spawn new process. 


format‘of bitmap file v2. sccecscrscaaiensiieiasint ice mane 
format of cpio archive. 
fOrMaAt-OF CITE CHOMIES oi vss cessssassccossstaa sg sessesstastenesseisdessaces Scsuszsestesss 
format of file system VOIUME ...........:cceeeseeseeeeseeseeeeeeseeeeeeneeneees 
format of memory image file... 
format tables for nroff or troff........ cece cess eeeseseeeteeeeeeees 
POTMALS ss iaevvsis he taceten Saul sla seeres eaaeoecae Maoesien owes cath ueauseaeeats 
formatted input conversion... 
formatted OUtPUL..... ce eee eseeeeeeseeseeseeeseeececsecseeeeeetseeseeeeeeaeeeees 
formatting a COCUMENE ........... ee eseeseseeeeceeeceecseeeeeeeseeseereneeaeeeees 
formatting and typesetting 
formatting cover sheets..... 
formatting manuscripts .. 
formatting requests.. 


Fortran 77 compiler. 
Fortran dialect... 
Fortran language preprocessor. 
Fortran programs............. 
fortune — cookies..... 
found — construct a file system ....... 
fprintf, sprintf — print formatted output. 
fputc, putw — put character or word on a.. 
fputs — put a string on a stream............. 
frand, nrand, srand — random number 
fread, fwrite — buffered binary . 


free, balloc, bfree, gcalloc, gcfree —.... eee eseeeeeeseeeeteeeeeeeeeeeneees 
free, realloc, ialloc, calloc, cfree — 


ANG-EXPOMENE Fis ccssssescscevsasawasascscassadesa vase stansasczseasasecsseaeseveestass 


news(5) 
pack(1) 
pt(4) 
rm(1) 
sort(1) 
mv(1) 
bundle(1) 
fstab(5) 
filsys(5) 
d202(1) 
plot(1) 
find(1) 
refer(1) 
ptopen(3) 
find(1) 
look(1) 
ttyname(3) 
finddev(8) 
spell(1) 
finddev(8) 
blitmap(9.1) 
dbm(3) 
cards(6) 
filsys(5) 
hoc(1) 
floor(3) 
cflow(1) 
fclose(3) 
column(1) 
font(9.5) 
font(7) 
jf9.1) 
font(9.5) 
string(9.3) 
font(7) 
fopen(3) 
tolower(3) 
weather(7) 
fork(2) 
ar(5) 
bitfile(9.5) 
cpio(5) 
dir(5) 
filsys(5) 
core(5) 
tbl(1) 
map(5) 
scanf(3) 
printf(3) 
doctype(1) 
troff(1) 
mcs(7) 
ms(7) 
deroff(1) 
getarg(3) 
port(3) 
f77(1) 
ratfor(1) 
efl(1) 
struct(1) 
fortune(6) 
mkfs(8) 
printf(3) 
putc(3) 
puts(3) 
rand(3) 
fread(3) 
df(1) 
alloc(9.3) 
malloc(3) 
fopen(3) 
frexp(3) 


CONVERSION 56528 scbscecesasstececstasssssstscelaccabsstvcascasatsnedccdeaseaunes scanf, 
interactive repair. 

SUCAIN a3 Sepsis Seses seta enesagcase speak saceaves seas sadesvek edd saves¥esspadsadedeaeseasoezed 

split, 

FINES Y SLEDS: 5 cicevucenccicsassautennessoedeseecconsoteiguatenasrasensccceateseveueete 

stat, Istat, 

fseek, 

time, 

fread, 


allocation with garbage collection... 


bridge — card 

crabs — graphical marine adventure 
rogue, wump — dungeon-exploration 
boggle, hangman, scrabble — word 
canfield, cribbage, fish — card 

demo — graphic demonstrations and 
snake, worm — display chase 

trek, ogre, sol, warp, sail — war 


COlleCtON EY. accede ain aceeanctoesnntenee galloc, gfree, 
town /- 

alloc, free, balloc, bfree, 

functions: absolute value,/..........ccccccesecesceeseeetseeeeee abs, sgn, 


alloc, free, balloc, bfree, gcalloc, 
ecvt, fevt, 


FOKOr anh cscs scssaccassaneus coves sacesdsouseasiansuncestesciscasecrisisasas cuttecanceves 
character or word from StreamM.........:.cceseeceeeeseeeeeeteeseeeeeeeseeneees 

getwd, 
STOUPS OF) elsseesescevessssnesreuvsasisseaceseisedsee getuid, getgid, geteuid, 
USEF, QYOUP, OF PLOCESS/...... eee eect eeteeeeeeee getuid, getgid, 


string, defont, strwidth, infont, outfont, 
endfsent — get file system descripto/ .......... eee eee 
— get USeT, QFOUP, OF PLOCESS/.......eeeseeeeeeseeeeeeneeseeeeeees getuid, 
endgrent — get group file eMtry .........ceeeceeeseeeeeeeeeteeeeeeeeeeeees 


PLOCESS/ sete ads getuid, getgid, geteuid, getegid, 
/muxnewwind, newwindow, tolayer, debug, 

setpwent, endpwent, pwdecode — get/.......ee cece 
cursinhibit, cursset, cursswitch, 


getppid — get user, group, OF PLOCESS/.........cesseeceeeeteeseeeeneeeeeee 


garbage Collection... cseceeesseseeeeeeeseeseeeeseeseeeeeeeaeeeeees galloc, 
file system ............. 
and time to ASCIL.. 


..ctime, localtime, 
setjmp, longjmp — non-local 


cflow — generate C flow 

graph — draw a 

demo — 

crabs — 

Itexture, upfront — layer control and 

Rpt, display, Drect, Jrect — basic jerq 
plot — 

screenswap, segment, texture — basic jerq 
vec, move, etc. — 

plot — 

grap — pic preprocessor for drawing 
mugs — convert 

/functions: absolute value, sign, 

PAULIN, .cscsccicisncsscedsessess caaeva saseossdusdesanedsssadseseseetwsvecadcoes¥oussaness 
chown, chgrp — change owner or 

newgrp — log in to anew 


getgrnam, setgrent, endgrent — get 


ae) ie 


fscanf, sscanf — formatted input... ec eeeeeeeteeeeeeeseeseeeeeeneeeees 
fsck — file system consistency check and.. 
fseek, ftell, rewind — reposition a....... 
fsplit — split a file into pieces.......... 
fstab — static information about the. 
fstat — get file status 0.0... 
ftell, rewind — reposition a stream... 
ftime — get date and time... 
ftw — file tree walk... 
fwrite — buffered binary input/output. 
galloc, gfree, garbage — storage... 
game.... 
game. 
games... 
games.. 
PAMES se scieissvivsseaiuatauceniateda dat uhetteuuiaee dation d ony 
BAINES joins c ii sissies sssdvades covons scucosgssutonousvs toesen ie go ieananien dedcorsuserbecsesson® 
games.. 
games 
gamma — log gamma fUNCTION...........ceeeeeseeeeteesceeeeeseeeeteeeeeseeees 
garbage — storage allocation with garbage : 
Gazetteer Of US places eiscscisscsses.deeascaecesezsesdvecncsscgeateascuscaseocertass’ 
gcalloc, gcfree — allocate MEMOTY «0.0... seeeeeseeseeeeteeeeeeeeeeeeeeee 
gcd, lcm, min, max — integer arithmetic. 
gcfree — allocate MEMOTY.........ceeeeseeeeseeseeeeteeseesceeceeeaeeeeeeeaeeneees 
CVE — OULPUL CONVETSION........eeeceeeeeeeseeseeeeteeseeseeecseeaeeeeeeseeaeees 
getarg, iargc - command arguments to. : 
getc, getchar, fgetc, getw — Set. ee eeesceceecneeeeeeeeeeeseeeeteeseeees 
getcwd — get current GireCtOry ........ ee eeceeseeeseeseesceecteeaeeeeeeeseeneeee 
getegid, getpid, getppid — get user, . 
getenv — value for environment NaMe.............seceeeeeseeeteeteeeeeees 
geteuid, getegid, getpid, getppid — get 0.0.0... eeeseeseeeeeeeeeeeeeee 
getfont — jerq text and font operations .. : 
getfsent, getfsspec, getfsfile, setfsent, 0.0... ccseeeeeeseeteteteeeeees 
getgid, geteuid, getegid, getpid, getppid oe. ee eeeseeeeeeeeeeeeee 
getgrent, getgrgid, getgrnam, setgrent.,.. 
getlogin — get login NAME... eeeceeeeceseeeceeceeseeeeeeeseeeeneeseeseeees 
getopt — get option letter from argy 0... eeeseeseeseeeeseeseeeeteeseeees 
getpass — read a password 3 
getpid, getppid — get User, SrOUD, OF ........:eceeeseeseeeeteeseeeeeeeseeeeeee 
getproc, getproctab — jerq Process/........ eee eseeeeeeeeeeeee 
getpw, getpwent, getpwuid, getpwnam,, 
getrect123 — mouse Control ..0... eee eects 

gets, fgets — get a string from a StreaM........ ee eeeeeeeseeeeeeteeeeeees 
getty — set terminal mode ‘ 
getuid, getgid, geteuid, getegid, getpid, 00... cc eceeeeeseeteeeteeteeees 
getuid, id — get user Identity... ee eeeeceeeeneesceeeeecseeeeeeteeeseeees 
getw — get character or word from stream. ‘ 
getwd, getcwd — get current direCtOry.........ccceseeeeeeseeeeeeeeeeeees 
gfree, garbage — storage allocation With ..........cceceeseeeeeeneeeeeee 
gmount — mount or remove non-standard. 
gmtime, asctime, timezone — convert date... 


... adventure, zork, aardvark, 


graphic demonstrations and games . 
graphical marine adventure game ............:eseeceseeseeeeteeeeeeeeeseeneees 
graphics .../lpoint, lrectf, lsegment, 
graphics data types... eereeeeees /Texture, Pt, Rect, 
graphics filters.. 
graphics functions 
graphics interface. 
graphics interface. 


gray-scale pictures into icons............. 
greatest common divisor, least common/.. 
grep, egrep, fgrep — search a file for a... 


group — group file ats 
group file Entry 00... eeeeeceeeseeeeeeeeeeseeeeeeeeees getgrent, getergid, 


scanf(3) 
fsck(8) 
fseek(3) 
split(1) 
fstab(5) 
stat(2) 
fseek(3) 
time(2) 
ftw(3) 
fread(3) 
galloc(3) 
bridge(6) 
crabs(9.6) 
adventure(6) 
boggle(6) 
cards(6) 
demo(9.6) 
snake(6) 
trek(6) 
gamma(3) 
galloc(3) 
town(7) 
alloc(9.3) 
arith(3) 
alloc(9.3) 
ecvt(3) 
getarg(3) 
getc(3) 
getwd(3) 
getuid(2) 
getenv(3) 
getuid(2) 
string(9.3) 
getfsent(3) 
getuid(2) 
getgrent(3) 
getlogin(3) 
getopt(3) 
getpass(3) 
getuid(2) 
newproc(9.2) 
getpwent(3) 
button(9.2) 
gets(3) 
getty(8) 
getuid(2) 
getuid(1) 
getc(3) 
getwd(3) 
galloc(3) 
gmount(2) 
ctime(3) 
setjmp(3) 
grap(1) 
cflow(1) 
graph(1) 
demo(9.6) 
crabs(9.6) 
newlayer(9.2) 
types(9.5) 
plot(1) 
bitblt(9.3) 
plot(3) 
plot(5) 
grap(1) 
mugs(9.1) 
arith(3) 
grep(1) 
chown(8) 
newgrp(1) 
group(5) 
getgrent(3) 


setuid, setgid — set user and 

chown, fchown — change owner and 

getegid, getpid, getppid — get user, 

operations........ ioctl, stty, 


document............ 


reboot — reboot system or 
re_comp, re_exec — regular expression 
regsub, regerror — regular expression 


boggle, 
run commands at low priority or immune to 
worms, 


blitblt — make 


ul, 
paper — list input on 
sinh, cosh, tanh — 


GOC ALOE civincasssice iene malloc, free, realloc, 
getarg, 


icont, iconc — 
mugs — convert gray-scale pictures into 


setuid, setgid — set user and group 
getuid, 
su — substitute user 


getuid, id — get user 
getppid — get user, group, or process 


signal — catch or 

blitblt — make hard copy of screen 

coreid — identify source of core 

core — format of memory 

nohup — run commands at low priority or 

OPCLAatlOMs se ieicss. wasveceregs esiaeicecwesoaececseseeees in host, in ntoa, 
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group ID 
group of a file... 
group, or process identity 
gtty — miscellaneous stream control 
guess command line for formatting a 
halt processor 
handler 
ane r sseycesceaee cescssteaspescaeeh pen dose eevee ecevsennee regcomp, regexec, 


hard copy of screen image 
hoc — interactive floating point language. 
hp — print underlines on screen terminals ...... 
HP2621P printer 
hyperbolic functions... 
hypot, cabs — euclidean distance... 
ialloc, calloc, cfree — main memory.. 
iargc — command arguments to Fortran 
icheck, dcheck, ncheck — file system 
icon — icon editOF oo... 
Icon language translator and compiler.. 
WCONS secttucicteies scan ewssayistees tutte ove 


id — get user identity. 
id temporarily 
ideal — troff preprocessor for drawing 
identify and manipulate magnetic tape 
identify source of core image 
identity .... 
identity oe 
idiff — interactive file comparison 
ignore signals 
image.... 
image.... 
image file .... 
immune to hangup 
in address, in service - internet.. 


tgetstr, tgoto, tputs — terminal 

ptx — permuted 

/strrchr, strpbrk, strspn, strcspn, strtok, 

syscall — 

font operations..........eeeeceeeeeeteeeeteeee string, defont, strwidth, 
fstab — static 

newsrc — 

Internet OPETALONS ¥.j2ccsicicescasesvacscdescaccsccoeaicosecsiasenasceudvecsedssess 


ttys — terminal 

windows, jps, reshape — create and 

popen, pclose — 

OPCLALLOMS jos sesseavecicssates cacccshovedsuqeciesiavens asccussevocbessastante in host, 


independent operation routines 
WIDEK -) cessvescdessteaasstescclecssveeseeniesss 
index, rindex — string operations. 
indirect system call 
infont, outfont, getfont — jerq text and.. 
information about the filesystems 
information file for readnews 
in host, in ntoa,in address, in service - 
init — process control initialization... 
initialization data 
initialize windows.... 
initiate IO to/from a Process... 
in ntoa, in address, in service - internet 


../tgetflag, 


filsys, flblk, 

clri — clear 

scanf, fscanf, sscanf — formatted 
paper — list 

ungetc — push character back into 
fread, fwrite — buffered binary 

stdio — standard buffered 

ferror, clearerr, fileno — stream status 
uustat — uucp status 

refer, lookbib, pubindex — find and 
in_host, in_ntoa, in_address, 

add, sub, mul, div, eqpt, eqrect, 

pi, 3pi — process 

CIStHIDULION fs scsssesssessseasecssretssseniecs ndarereeseeereaeereaess mkpkg, 
learn — computer aided 

cons — console 

dk — Datakit 

mouse — jerq mouse user 

mt — magtape 


ino — format of file system volume... 
i-node 
input conversion... 
input on HP2621P printer 
input stream.............. 

input/output.......... a 
input/output Package... eee cesses eseeseeecseseteeseseeeseeseeseees 
MQUITIOS e024. cssiecaneeccasetavie wert oeteveeee 
inquiry and job control 
insert literature references in documents.. 
in_ service - internet operations......... 
inset, muldiv, ptinrect, raddp, rsubp,/ 
inspector 
inspkg, seal, unseal — automatic software 
instruction about UNIX 
interface. 
interface. 
interface. 
interface. 


setuid(2) 
chown(2) 
getuid(2) 
ioctl(2) 
doctype(1) 
reboot(2) 
regex(3) 
regexp(3) 
hang(1) 
boggle(6) 
nice(1) 
worms(6) 
blitblt(9.1) 
hoc(1) 
ul(1) 
paper(1) 
sinh(3) 
hypot(3) 
malloc(3) 
getarg(3) 
icheck(8) 
icon(9.1) 
icont(1) 
mugs(9.1) 
icont(1) 
setuid(2) 
getuid(1) 
su(8) 
ideal(1) 
tape(1) 
coreid(1) 
getuid(1) 
getuid(2) 
idiff(1) 
signal(2) 
blitblt(9.1) 
coreid(1) 
core(5) 
nice(1) 
internet(3) 
termcap(3) 
ptx(1) 
string(3) 
syscall(2) 
string(9.3) 
fstab(5) 
newsrc(5) 
internet(3) 
init(8) 
ttys(5) 
windows(9.1) 
popen(3) 
internet(3) 
filsys(5) 
clri(8) 
scanf(3) 
paper(1) 
ungetc(3) 
fread(3) 
stdio(3) 
ferror(3) 
uustat(1) 
refer(1) 
internet(3) 
add(9.3) 
pi(9.1) 
asd(8) 
learn(1) 
cons(4) 
dk(4) 
mouse(9.4) 
mt(4) 


vec, move, etc. — graphics 

plot — graphics 

pads — user 

can, bean, dcan, tcan, xcan — 

telnet — user 

netstat — show network status for ARPA 
ropy — remote file copy for arpa 

in host, in ntoa,in address, in service - 
asa — 

ascii — 

jx — jerq execution and stdio 

pascal — language 

sno — Snobol language 

lisp, liszt, lxref — lisp 

proof — troff output 

basic, bas, bite — Basic language 

pipe — create an 


intro — 

PUIMIDELS 5 fsgeossreia disses tassiseieiessbasvatinecavatessuecgeisvasee intro, errno — 
mux, ismux, 

vis — show 

iostat, load, dkstat — report 

stream — stream 

pt — interprocess 

select — synchronous 

sendchar, sendnchars, kill, exit — jerq 

showg — state of stream 

popen, pclose — initiate 

jioctl — jerq 

CONtrO] OpPeratioNnS .........ceeeeeseeceteeeeeeeeeseeeeeeeseeseeeeeeeaeeeeeeeseeaeees 


SUALISLICS Sissete.ccesintucsece uyavtenieas a vivecetteauastelenuuen det ueuseee 
isalpha, isupper, islower, isdigit, 

ttyname, cttyname, 

isalnum, isspace, ispunct, isprint, 

POUQ:sicstkssecnetsassnevessevasevs sispisarsueasitusseaiossasnattaseatverssvanioed? mux, 


/isdigit, isalnum, isspace, ispunct, 
system — 
.isalpha, 


isspace, ispunct, isprint,/ o 
mget, mput, mmov, mcmp, mexp, mpow -/.... 


blitmap — map plots and path finding on a 
elarc — circle drawing functions for 
face — show faces on 

ismux, invert — layer multiplexer for 
proof — troff output interpreter for 
jx- 

font — 

Rect, Rpt, display, Drect, Jrect — basic 
screenswap, segment, texture — basic 
sendchar, sendnchars, kill, exit — 
jioctl — 

mouse — 

tolayer, debug, getproc, getproctab — 
strwidth, infont, outfont, getfont — 
intro — introduction to 


JO, jl, 
uustat — uucp status inquiry and 


APNG VS acai gash cnt rasau evolve cei gea wud Re a tue a ads windows, 
/Texture, Pt, Rect, Rpt, display, Drect, 
pt — interprocess I/O 


request, own, wait, alarm, sleep, nap, 
config — configure a Unix 
makekey — generate encryption 
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interface. 
interface. 
interface package 
interface to Canon laser-printer spooler 
interface to the telnet protocol. 
internet 
internet... ees 
internet Operations...........ceeeeeeeteeeees 
interpret ASA control characters. 
interpret ASCII characters ................ 
interpreter... 
interpreter... 
interpreter 
interpreter and compiler. 
interpreter for jerq 
INterpreters 0... eee eens 
interprocess channel....... 
interprocess I/O junctor files. 
introduction to commands. Re 

introduction to jerq-related software 
introduction to library functions ............. 
introduction to system calls and error 
invert — layer multiplexer for jerq.. 
invisible characters................ 
I/O and CPU statistics 
1/O control calls........ 
I/O junctor files. 
I/O multiplexing 
I/O requests .... 
I/O system 
10 to/from a process. 
ioctl requests ............ 
ioctl, stty, gtty — miscellaneous stream 
iostat, load, dkstat — report I/O and CPU 
isalnum, isspace, ispunct, isprint,/......... 
isatty, ttyslot — find name of a terminal... eeeseeeeeeneeeeeee 
iscntrl, isascii — character/..............0.. 


isprint, iscntrl, isascii — character/ 
issue a shell command................ 
isupper, islower, isdigit, isalnum, ............... 

itom, madd, msub, mmul, mdiv, msqrt, mgc 
jO, jl, jn, yO, yl, yn — bessel functions 
jerq.... 
jerq. 


jerq on 
jerq execution and stdio interpreter... 
jerq font layouts «0.0... 
jerq graphics data types 
jerq graphics functions 
jerq I/O requests 
jerq ioctl requests 0.0.0... 
jerq mouse user interface .. 
jerq process control 
jerq text and font operations .......... 
jerq-related software ...... 

jf — font editor...... 
jim, jim.recover — text editor. 
jioctl — jerq ioctl requests 
jn, yO, yl, yn — bessel functions 
JOb CONTIOL 0... eee eeeeeeeeeeeeeeteeeeee 
join — relational database operator . 
jps, reshape — create and initialize.. 
Jrect — basic jerq graphics data types 
Junctor files c:..<isciceiieseevetecisesiedeuseusiseeetiaenias 
jx —jerq execution and stdio interpreter. 
kbdchar, rcvchar, realtime, sendchar,/ 


/Texture, Pt, 
/point, rectf, 


/rcvchar, realtime, 


/newwindow, 
.../defont, 


TOCeSss 


plot(3) 
plot(5) 
pads(9.5) 
can(1) 
telnet(1) 
netstat(8) 
ropy(1) 
internet(3) 
asa(1) 
ascii(1) 
jx(9.1) 
pascal(1) 
sno(1) 
lisp(1) 
proof(9.1) 
basic(1) 
pipe(2) 
pt(4) 
intro(1) 
intro(9) 
intro(3) 
intro(2) 
mux(9.1) 
vis(1) 
iostat(1) 
stream(4) 
pt(4) 
select(2) 
request(9.2) 
showq(8) 
popen(3) 
jioctl(9.4) 
ioctl(2) 
iostat(1) 
ctype(3) 
ttyname(3) 
ctype(3) 
mux(9.1) 
ctype(3) 
system(3) 
ctype(3) 
mp(3) 
j0(3) 
blitmap(9.1) 
circle(9.3) 
face(9.1) 
mux(9.1) 
proof(9.1) 
jx(9.1) 
font(9.5) 
types(9.5) 
bitblt(9.3) 
request(9.2) 
jioctl(9.4) 
mouse(9.4) 
newproc(9.2) 
string(9.3) 
intro(9) 
jf(9.1) 
jim(9.1) 
jioctl(9.4) 
j0(3) 
uustat(1) 
join(1) 
windows(9.1) 
types(9.5) 
pt(4) 
jx(9.1) 
request(9.2) 
config(8) 
makekey(8) 
kill(2) 


Prejudice scsi eis Rite Haine aie haces reeetenertatiacese 
revchar, realtime, sendchar, sendnchars, 

mem, 

programming language .........ccceceesceseeeeeecteeeeeeeeeeseereeee ksh — 
mem, kmem, kmemr, 

integers and long inteQers..........ccseeeeeseeeeeeseeseeeceeeseeeeeeeseeaeees 


library, bellcat — bell 

telno — retrieve from Bell 

pattern-directed scanning and processing 

bc — arbitrary-precision arithmetic 

hoc — interactive floating point 

the not standard command programming 

— shell, the standard command programming 
spitbol — Snobol 

altran — 

pascal — 

sno — Snobol 

basic, bas, bite — Basic 

cpp-C 

efl — extended Fortran 

icont, iconc — Icon 

paint — draw pictures in a 

Irectf, lsegment, ltexture, upfront — 

mux, ismux, invert — 

font — jerq font 

Itexture, upfront /.... eee newlayer, dellayer, 
functions: absolute value,/ ........cc eee eceeeeeeeeees abs, sgn, gcd, 


/value, sign, greatest common divisor, 


monk, monksample — typeset documents and 

PLOBLAMS MSs: eeliitae dealin divatwacnwen aacccunnguncss 
number, generate large Primes ...........seseeeeeseeeeeeeeeeees factor, 
ranlib — convert archives to random 

SCLVICES oi Sgaidiessagesciacccowases ec cass Giearccessoutiastosensthpaeeiee.dostaseens 
ar — archive ( 

port — mathematical 

intro — introduction to 

ar, ranlib — archive and 

library, bellcat — bell labs 

buf_ld — buffering 

mesg, rmesg — message 

doctype — guess command 

Ipd — 

Ipr— 

Icomp, Iprint — line-by- 

comm - select or reject 

COdG sinc icicern weatadnccethsngeienceoona Meceeeeeates random — sample 
uniq — report repeated 

look — find 

rev, revpag — reverse 


a.out — assembler and 
In — make 


lisp, liszt, Ixref — 

look — find lines in a sorted 

nlist — get entries from name 

nm — print name 

varargs — variable argument 

Is — 

paper — 

printer, profiler, and cross-reference 

GCOMPIUESLs 5 eewpesseeseetee ease das tts sie amtopedeetpese neers lisp, 
lookbib, pubindex — find and insert 
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kill — terminate a process with extreme...........ccececeeeeseeeeeeseeneeee 
kill, exit — jerq I/O requests............. .../kbdchar, 
kmem, kmemr, kUmem, mtpr — main meMOT)...........:s:eeeeeeeeee 
Korn shell, the not standard command......... 
kUmem, mtpr — main memory........ 
13tol, Itol3 — convert between 3-byte . 
lab — label maker... 
labs library services. 
Labs phone book.. 
language........ 
language. 
language. 
language.. 
language............ os 
language compiler....... 
language for algebraic manipulation............cceeceeeseeeeeceeeeneeeeees 
language interpreter... ceceessescesceeeseeseeeeeeeseeseeeseeaeeseeeseeaeees 
language interpreter. 
language interpreters .........ccceecessescesceecseeseeeeeeeseeseeeseeaceeeeeeneeaeees 
language PreProCesSOl........ ce seceeseeseseeeeeeeeeeeeeeeeteeeeeeeeeeeeeeeeeeeeeeees 
language preprocessot.............. 
language translator and compiler ..........c.ceceecsseeseeeeteeeeeeeeeeeeneees 
DAV OL es eccavensdecaselsvsdend ets dvvascegeashxaa cic ecanay ons teeee haven teet ear evsveeseesienss 
layer control and graphics.. 
layer multiplexer fOr jer ........eceeeseeseeeeseeseeeeeeeeeseeeeaeeaeeeeeeseeneees 
Vay Outs: tavvs escaeectesavstencetva avaucetscal syeateseccausy ens seeee Cavveasustecvevapeeestaceass 
Ibitblt, Ipoint, Irectf, lsegment.,.... 
Icm, min, max — integer arithmetic ..........: cc eeeeeseeeeneeeeeeeeeeeneeee 
Icomp, Iprint — line-by-line profiler... ceeceeeeeeseeeeeeteeseeees 
Id — link editor 
Idexp, modf — split into mantissa and .........eeeeseeeseeseeeeeeeneeeeeee 
Idpcs — load comet MIcrOCOdE.........:eceeeseeseeeeteeseeeceeeseeeeeeeeeeseeees 
learn — computer aided instruction about 
least common multiple, minimum, maximuM............ eee 
lens — bitmap 
letters 
lex — generator of lexical analySis........c.cesecesesceceeeeteeseeeeteeseees 
Ifactor, qfactor, primes — factOr Ao... eeeseeseeeeseeeeeeteeseeeeeeeseeneees 
libraries , 
library, bellcat — bell labs library 00.0.0... eceeseseeeeeeeseeeeeeeeeeseeees 
library) ‘file format .c.2.. cient ernceeso eg teeiasioe ice omndaene 
library for Fortran 
Library: fUnCti OMS: sisisssessesvssasiseesssadussgsvesuaatestaxeescistassases cea saeasestessa 
library. maintainer +, 0c.2..sczeeesiesetteeasoeeidienniteceeeonniaete 
library services. 
Vine discipline vsacccssesszizsvivvaassageescasdescasvancaniastascessistaasasci sea vaeasestents 
line discipline MOdUIeS ..........eeeeteeeeeeseeseeeetetseeseeeeseeaeeeeeeeneeaeees 
line for formatting a document. 
line printer daemon ..........eeeceeeseeseeseeeeseeseeeeeeeseeseeeeaeeaeeeeeeeneeaeees 
line printer: spooler. x ccii.cscieccda usa acavarieacccccuteaiceaviceiete sts 
line profiler... eeeeeeeeeeeees 
lines common to two sorted files 
lines from a file or provide random exit 
lines in a file... eee 
lines in a sorted list . 
lines or pages ... 
link editor......... 


.awk — 


ksh — Korn shell, 
sh, cd, wait 


lisp interpreter and compiler. 
ViStiassfcsstveehs tel Gadeeieae 


list contents of directory.... 
list input on HP2621P printer .. ys 
liszt, Ixref — lisp interpreter and .0.......c.cececeeeeseeeeeeneeeeeeeeeeseeneeee 
literature references in documents... 
Vin Serra Hk «cs ssessa cosvsssieasa ctessesdassasdescaatagiasececesigasgsccssavadasi dees 


kill(1) 
request(9.2) 
mem(4) 
ksh(1) 
mem(4) 
13tol(3) 
lab(1) 
library(7) 
telno(7) 
awk(1) 
be(1) 
hoc(1) 
ksh(1) 
sh(1) 
spitbol(1) 
altran(1) 
pascal(1) 
sno(1) 
basic(1) 
cpp(8) 
efl(1) 
icont(1) 
paint(9.1) 
newlayer(9.2) 
mux(9.1) 
font(9.5) 
newlayer(9.2) 
arith(3) 
Icomp(1) 
Id(1) 
frexp(3) 
Idpcs(8) 
learn(1) 
arith(3) 
lens(9.1) 
monk(1) 
lex(1) 
factor(1) 
ranlib(1) 
library(7) 
ar(5) 
port(3) 
intro(3) 
ar(1) 
library(7) 
bufld(4) 
mesg(4) 
doctype(1) 
Ipd(8) 
Ipr(1) 
Icomp(1) 
comm(1) 
random(1) 
uniq(1) 
look(1) 
rev(1) 
Id(1) 

a(5) 
link(2) 
In(1) 
lint(1) 
lisp(1) 
look(1) 
nlist(3) 
nm(1) 
varargs(3) 
Is(1) 
paper(1) 
pxp(1) 
lisp(1) 
refer(1) 
In(1) 


logarithm, power, SQUaTE TOOL.........eeeeeeseeeetseteeseeeeneeneeeees exp, 


ac — 
dcon, ndcon, rx, rogin, rsh — remote 
getlogin — get 

passwd — change 

utmp, wtmp — 

last — report recent 

setjmp, 


UpHONt SH vecveissasicteseeteasiieveoninnccs newlayer, dellayer, Ibitblt, 
Icomp, 
Number Generator... ee eeeseeceeeeseeseeecteeseeeeeeceeaeeeeeeeaeeaeees rand, 


newlayer, dellayer, lbitblt, Ipoint, 


/dellayer, lbitblt, Ipoint, Irectf, 

Stat, 

/lbitblt, Ipoint, Irectf, lsegment, 

ANd lONS ANE SETS weeds syess eects esisce. wens hadi osbive ners diakeeaes 13tol, 
lisp, liszt, 


3cc, 3as, 3ar, 3nm, 3size, 3strip, cprs — 

server — run anonymous command on another 
pwd, where — print 

m4 — 


mput, mmov, mcmp, MeXP, MPOW —/......eeeeeeseeeeeeeteeeeee itom, 
tape, mt — identify and manipulate 

mt — 

Mail — send and receive 

mail — send or receive 

xsend, xget, enroll — secret 


post — send 

upas — address driven 

mem, kmem, kmemr, kUmem, mtpr — 
free, realloc, ialloc, calloc, cfree — 
make — 

ar, ranlib — archive and library 


mkdir — 

mknod — 

mktemp, tmpnam — 
blitblt — 

In- 

mkdir, rmdir — 


lab — label 
cfree — main memory allOcatOL......... ec eeeeeeesceeeeeeeeeeeeeeeeeneeee 


tape, mt — identify and 

altran — language for algebraic 
frexp, Idexp, modf — split into 
man — print sections of this 


-16- 


load comet MicrOCOdE ...... eee eect e esses eeeseeetecseseeetecaeecetseseeesas 
load, dkstat — report I/O and CPU... 
loader for 5620.0... ieee eee 
localtime, gmtime, asctime, timezone 
locations in program ... 
log gamma function... 
log in to a new group ....... eee 
log, log10, pow, sqrt — exponential... 
login — SIQN OM .....eeeeeeeeeeeeteeeeee 
login accounting... 
login and execution. 
login name............ 
login password. 
login records . 


longjmp — non-local QOto......eeeseeeeeeseeeeeeseeeeseeeeaeeaeeeeeeeseeaeees 
look — find lines in a sorted list... cece eeeneeeeeeees 
look up words in English dictionaries. 
lookbib, pubindex — find and insert ..........cccseseeeeeeseeeeeeeeeeseeees 
TO Wer CASE iwccrs sss satscties cosons steccdastanin cus cosen ta giplednateuyis covsuberbeocgesors 


Ipr— line printer spooler 
Iprint — line-by-line profiler 
lrand, frand, nrand, srand — randOm.............cccccccccsccesseeesecesseesseees 
Irectf, lsegment, Itexture, upfront —/........ ee eeseeseeeeneeeeeeeeeseeneeee 
ls — list contents of directory 
Iseek, tell — move read/write pointer ...........cceeeseeeeeeseeeeeeteeeeees 
Isegment, Itexture, upfront — layers 00.0... eceeeeeeseeseteeeeeeeeeeeeeneeee 
Istat, fstat — get file status 


Itol3 — convert between 3-byte integers «0.0... eeeeseeseeeeeeeneeeeeee 
Ixref — lisp interpreter and compiler... 
M4 — MACLO PLOCESSOT oo. eeeeeeeeeseseseseseseeeseeteeseseeeseseeeseeteeseenetees 
MAC-32 C compiler for 5620 ........:ececesceseeeeteesceceeeceeeeeeeeeeseeees 
machine : 


macro processor 
macros for formatting cover sheets. 
macros for formatting MAaNUSCTIPts ..........eceeeseeteeeeneeeeeeeeeeneeeeeee 
macros to typeset Manual... cece eeeeeeeeeeeeeeeeeeeeteeeteeeeeeeeeeeees 
madd, msub, mmul, mdiv, msqrt, mgcd, meget. 
MA STCC. CAPE sco cccdecisa cesses vzansisvecsssduasa Feascaasssaioessistas casei cea saeasestess: 
magtape INterlace 4 ecccssctetvsresethecao aiden ida reeeyomnaene 
mail 


mail — address conventions and rewrite 
Mail — send and receive mail ...........cccceceeseesseeseeseeseeeeeeseeneeeseenees 


MMLAMN TE MOLY: 2. eiasecs desea veycaee ceca seisegeacesaseesienscscucvupeasarscoovvaseccteass 
main memory allocator ............ 
maintain collections Of programs ..........:cseceeceseeseeeeneeeeeeeeeseeeeees 
WAIMALI SLs a sk Sates eds ves sesgedsssseesss oenssse 

make — maintain collections of programs . 
make a directory........ceeeeeeeeeees 
make a directory or a special file 
make a unique file name............. 
make hard copy of screen image. 
make links... eee 
make or remove a directory ........ 
makekey — generate encryption key... 
MAKED iscceirerhssastaeencafescnsennerdae steeds 
malloc, free, realloc, ialloc, calloc, . 
man — macros to typeset manual..... 
man — print sections of this manual 
Manipulate Magnetic taPen........eceeceeeeseeseeceteeeeeceecteeaeeseeeeseeaeees 
MANA PU ALON 2 ccesssva cuts ces coweev cava sannetgucesascesieancteataaaterdecsmeewenenas 
mantissa and exponent... 


Idpces(8) 
iostat(1) 
321d(9.1) 
ctime(3) 
end(3) 
gamma(3) 
newgrp(1) 
exp(3) 
login(8) 
ac(8) 
dcon(1) 
getlogin(3) 
passwd(1) 
utmp(5) 
last(1) 
setjmp(3) 
look(1) 
dict(7) 
refer(1) 
tolower(3) 
Ipd(8) 
newlayer(9.2) 
Ipr(1) 
Icomp(1) 
rand(3) 
newlayer(9.2) 
Is(1) 
lseek(2) 
newlayer(9.2) 
stat(2) 
newlayer(9.2) 
13tol(3) 
lisp(1) 
m4(1) 
3ec(9.1) 
server(1) 
pwd(1) 
m4(1) 
mcs(7) 
ms(7) 
man(7) 
mp(3) 
tape(1) 
mt(4) 
Mail(1) 
mail(1) 
xsend(1) 
mail(7) 
Mail(1) 
mail(1) 
post(1) 
upas(8) 
mem(4) 
malloc(3) 
make(1) 
ar(1) 
make(1) 
mkdir(1) 
mknod(2) 
mktemp(3) 
blitblt(9.1) 
In(1) 
mkdir(2) 
makekey(8) 
lab(1) 
malloc(3) 
man(7) 
man(1) 
tape(1) 
altran(1) 
frexp(3) 
man(1) 


man — macros to typeset 
troff — addenda to troff 
ms — macros for formatting 


map — digitized 

ascii — 

blitmap — 

orient, normalize — 

map — draw 

crabs — graphical 

umask — set file creation mode 


cos, sin, atan2, sqrt, norm — integer 
port — 

visi — 

eqn, neqn, checkeq — typeset 


calculator 
absolute value,/.... 


abs, sgn, gcd, lcm, min, 
col, 2-6, 
/mmul, mdiv, msqrt, mgcd, mget, mput, mmov, 


MEXP, MPOW —/......eeeeeceeseeeeteeeeeeenee itom, madd, msub, mmul, 
ruler — 

bed, ppt — convert to antique 

DMC MOLY esseses sean sersencea ors exerted aaa see dalea sal was sao bas RRR 
MCMMIOLY. OPELALONS <.eetessecisseee ccesareececssesauseaguesevenasvedihelognsten tween 
balloc, bfree, gcalloc, gcfree — allocate 

mem, kmem, kmemr, kUmem, mtpr — main 

realloc, ialloc, calloc, cfree — main 

core — format of 

memccpy, memchr, memcmp, memcpy, memset — 

vmstat — report virtual 

memccpy, memchr, memcmp, memcpy, 

menuhit — present user with 

sort — sort and/or 


INOCUIES. Sree oesesce aa aiveccrsc meses anata snares teeeteautstucersimaceee 
dmesg — system diagnostic 

mesg — permit or deny 

sys_errlist, sys_nerr— system error 

/mdiv, msqrt, mgcd, mget, mput, mmov, mcmp, 

Idpcs — load comet 

absolute value, SIQt,/.......cccseseeeeeeeeeeeeeee abs, sgn, gcd, lcm, 
ioctl, stty, gtty — 

Sy Stem ...ncevc aie aa i ee ices mkfs, 


msub, mmul, mdiv, msqrt, mgcd, mget, mput, 
chmod — change 

getty — set terminal 

umask — set file creation 

chmod, fchmod — change 

tset — set terminal 

frexp, ldexp, 

touch — set file 

newer — test file 

mesg, rmesg — message line discipline 


IGtterss. .csisissesseevezsriteeeests 


Pp, 
— screen functions with ‘optimal’ cursor 
mount, umount — 

mount, umount — 

gmount — 


= iF = 


manual 
manual 
manuscripts 
map — digitized map formats. 
map — draw maps on various projections. 
map formats «0.0... eee 
map of ASCII character set.. 

map plots and path finding or ona jerq. 
map projections 
maps on various projections.. 


math fUNCtIONS....... ce eeeeeeeeeeteereeeee 
mathematical library for Fortran. 
mathematical spreadsheet 
Mathematics ..0.....:ceseceeeeseereeeeeeeeeees 
matlab — interactive matrix desk. 
max — integer arithmetic functions:... 
mc, fold, expand — column alignment... 
memp, mexp, mpow — multiple precision/ 
mes — macros for formatting cover sheets 
mdiv, msqrt, mgcd, mget, mput, mmov, mcmp, 
measure things on the screen 


mem, kmem, kmemr, kUmem, mtpr — main.. 
memccpy, memchr, memcmp, memcpy, memset -........... 


memory... 


memory allocator .... 
memory image file... 
memory operations... 
memory statistics 
memset — memory operations 
menu and get selection 
Merge les isc. s..sscsesscesesesss 
mesg — permit or deny messages... 
mesg, rmesg — message line discipline . 
messages 
MECSSAQES ose 
messages..... 
mexp, mpow — multiple pr precision integer/.. 
MICOCOdC ish ies sensi ceaee thie a eriils 
min, max — integer arithmetic functions: ....... 
miscellaneous stream control operations ....... 
mkbitfs, mklost+found — construct a file. 
mkdir — make a directory 
mkdir, rmdir — make or remove a directory ... 
mkfs, mkbitfs, mklost+found — construct a.... 
mknod — build special file 
mknod — make a directory or a special. 
mkpkg, inspkg, seal, unseal — automatic 
mktemp, tmpnam — make a unique file name .......... ee eeeeeeeeees 
mmov, mcmp, mexp, mpow — multiple/...... eee /madd, 
mode 


modf — split into mantissa and exponent.. 
modification date 
modification dates.... 
MOdUeSs, ci. esssiienessecensSteneredesnen eters 
monitor — prepare execution profile.. 
monk, monksample — typeset documents and 
more — paginate 
motion 
mount and dismount file system 
mount or remove file system. 
mount or remove non-standard file system.... 
mount, umount — mount and dismount file.... 
mount, umount — mount or remove file 
mounted file system table .........ccceceeeseeseeceeeeeeeceeceeseeeeeeeseeaeees 


man(7) 
troff(7) 
ms(7) 
map(5) 
map(7) 
map(5) 
ascii(7) 
blitmap(9.1) 
map(3) 
map(7) 
crabs(9.6) 
umask(2) 
cos(9.3) 
port(3) 
visi(1) 
eqn(1) 
matlab(1) 
arith(3) 
column(1) 
mp(3) 
mcs(7) 
mp(3) 
ruler(9.1) 
bed(6) 
mem(4) 
memory(3) 
alloc(9.3) 
mem(4) 
malloc(3) 
core(5) 
memory(3) 
vmstat(8) 
memory(3) 
menuhit(9.3) 
sort(1) 
mesg(1) 
mesg(4) 
dmesg(8) 
mesg(1) 
perror(3) 
mp(3) 
Idpcs(8) 
arith(3) 
ioctl(2) 
mkfs(8) 
mkdir(1) 
mkdir(2) 
mkfs(8) 
mknod(8) 
mknod(2) 
asd(8) 
mktemp(3) 
mp(3) 
chmod(1) 
getty(8) 
umask(2) 
chmod(2) 
tset(1) 
frexp(3) 
touch(1) 
newer(1) 
mesg(4) 
monitor(3) 
monk(1) 
p(1) 
curses(3) 
mount(8) 
mount(2) 
gmount(2) 
mount(8) 
mount(2) 
mtab(5) 


cursset, cursswitch, getrect123 — 

mouse — jerq 

vec, 

mv — 

lseek, tell — 

view2d — 

view2d, moviefil — 

view2d — 

view2d, 

msqrt, mgcd, mget, mput, mmov, mcmp, mexp, 


rarepl, rarct — replace bad blocks on 


ra— DEC 
MPOW. I vic cacesscveviciceasovensescete itom, madd, msub, mmul, mdiv, 
TAP Cucsesicedoseaisndiicdessucereusescusalsaeseeede suse Piausdeossseabensadbanseseevenslen tape, 


mem, kmem, kmemr, kUmem, 

a(G0) AERO ERR ET TREE RRC ree TSR METRE 
ptinrect, raddp, rsubp,/ ........ceeeeeceeeeseeseeeeseeeeeeeneeseeees add, sub, 
greatest common divisor, least common 

/mget, mput, mmov, mcmp, mexp, mpow — 

mux, ismux, invert — layer 

select — synchronous I/O 

POT ONG A icedeses cscs elas es fsaaea lucas cesstaaverstacstPeycvansareia eat ateraies 
term — nonstandard 

getproc, getproctab — jerq/ oo... ieee P, newproc, 


getenv — value for environment 
getlogin — get login 

mktemp, tmpnam — make a unique file 
post — send mail to users by 

tty — get terminal 

whoami — computer 

pwd, where — print machine 

nlist — get entries from 

nm — print 

ttyname, cttyname, isatty, ttyslot — find 
terminals — conventional 

interval. 


request, own, wait, alarm, sleep, 
icheck, dcheck, 
EX SCULL OL cc si is audcccset coteodases ces'dasdudauoees ccetecees acsvbeenoneeecevese dcon, 


internet. 


news — USENET 
netstat — show 

creat — create a 
newgrp — log in toa 
fork — spawn 


Irectf, lsegment, ltexture, upfront —/. 
debug, getproc, getproctab — jerq/ 


P. 


> 


UTA, TIES acess, asso seca cananccearea rset aeacen oat acca 
netnews — send or receive 

checknews, readnews — read 

news — print 

getproctab -/ oo... eee P, newproc, muxnewwind, 


dbminit, fetch, store, delete, firstkey, 
priority of running process by changing 


priority or immune to hangup..........ceeceeeeeeeseeeeeeteeseeeeeeeeeeees 
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mouse — jerq Mouse User Interface... eeeseeeeeeeeeteeeeteeteeeeeees 
MOUSE CONHIO] ...... ee eeeeeeeeeeeeseeeeneeseeeeeeenee 

mouse user interface. 
move, etc. — graphics interface.... 
move or rename files and directories 
move read/write pointer.............. 
movie of a function f(x, y, t) 
movie of a function f(x, y, t) 
movie of a function f(x, y, t).... 
moviefil — movie of a function f(x, y, t) 
mpow — multiple precision integer/ 
ms — macros for formatting manuscripts 
MSCP disks 
MSCP disks (RA60, RA80, RA81).. : 
msqrt, mgcd, mget, mput, mmov, mcmp, mexp, 
mt — identify and manipulate magnetic... 
mt — magtape interface... eee 
mtab — mounted file system table .. 
mtpr — Main MeEMOTY...........eeeeeeeeeeee 
mugs — convert gray-scale pictures into 
mul, div, eqpt, eqrect, inset, muldiv, 
multiple, minimum, maximum....... 
multiple precision integer arithmetic 
multiplexer for jerq 
multiplexing 
mux, ismux, invert — layer multiplexer 
MUX terminals 00.0... eceeeseeseeeeeeeeeeeeeeeees 
muxnewwind, newwindow, tolayer, debug, .. 
mv — move or rename files and directories .... 


name and working directory . 
name list... eee 
name list 


nap — suspend execution for a short...... 
nap, kbdchar, revchar, realtime, sendchar,/. 
ncheck — file system consistency check 
ndcon, rx, rogin, rsh — remote login and 
neqn, checkeq — typeset mathematics... 
netfs — network file system 
netnews — send or receive news articles 


network face server 
network file system 
network news article, utility files 
network status for ARPA internet 
new file 
new group 
new process.......... 
newer — test file modification dates .. 
newgrp — log in to a new group...... 
newlayer, dellayer, Ibitblt, Ipoint, ............... 

newproc, muxnewwind, newwindow, tolayer. 
news — print news items 
news — USENET network news article, 
news articles............. 
news articles... 
news items. 
newsrc — information file for. readnews 
newwindow, tolayer, debug, getproc, 
nextkey — database subroutines 


nice — set program priority 
nice, nohup — run commands at low 
nlist — get entries from name list... eeeceeeseeseeeeneeeeeeeeeteeeeeee 


mouse(9.4) 
button(9.2) 
mouse(9.4) 
plot(3) 
mv(1) 
lseek(2) 
view2d(1) 
view2d(3) 
view2d(5) 
view2d(3) 
mp(3) 
ms(7) 
rarepl(8) 
ra(4) 

mp(3) 
tape(1) 
mt(4) 
mtab(5) 
mem(4) 
mugs(9.1) 
add(9.3) 
arith(3) 
mp(3) 
mux(9.1) 
select(2) 
mux(9.1) 
term(9.1) 
newproc(9.2) 
mv(1) 
getenv(3) 
getlogin(3) 
mktemp(3) 
post(1) 
tty(1) 
whoami(5) 
pwd(1) 
nlist(3) 
nm(1) 
ttyname(3) 
term(7) 
nap(2) 
request(9.2) 
icheck(8) 
dcon(1) 
eqn(1) 
netfs(8) 
netnews(1) 
postnews(1) 
netstat(8) 
faced(9.5) 
netfs(8) 
news(5) 
netstat(8) 
creat(2) 
newgrp(1) 
fork(2) 
newer(1) 
newgrp(1) 
newlayer(9.2) 
newproc(9.2) 
news(1) 
news(5) 
netnews(1) 
readnews(1) 
news(1) 
newsrc(5) 
newproc(9.2) 
dbm(3) 
renice(8) 
nice(2) 
nice(1) 
nlist(3) 


clri — clear i- 

IMMUNE to hangup «0... eeeeeeeseeeeeeseesceeeeeeneeeceeceeaeeeeeeees nice, 
setjmp, longjmp — 

gmount — mount or remove 
term — 

cos, sin, atan2, sqrt, 

orient, 

ksh — Korn shell, the 

rand, lrand, frand, 

troff, 

tbl — format tables for 


English. 


lin 
Ifactor, qfactor, primes — factor a 

rand, lrand, frand, nrand, srand — random 
atof, atoi, atol — convert ASCII to 

— introduction to system calls and error 
seq — print sequences of 

number — convert Arabic 

size — size of an 

od - 

trek, 

twid — dabble in 


ROIVEL cnc saireace een Hanae iey dkdial, dkerror — 
ptopen — find and 

fopen, freopen, fdopen — 

dup, dup2 — duplicate an 

open — 

closedir — directory Operation ..........ccseseeeseeseeeeeeeeeeeeeeseeeeees 
savecore — save a core dump of the 

curses — screen functions with ‘ 

getopt — get 

stty — set terminal 


string, defont, strwidth, infont, 

a.out — assembler and link editor 
fread, fwrite — buffered binary input/ 
fprintf, sprintf — print formatted 
ecvt, fevt, gevt — 

proof — troff 

stdio — standard buffered input/ 
apsend — send troff 

revchar, realtime, sendchar,/ .............c:ccccccsscesseeeseeeneee request, 
chown, fchown — change 

chown, chgrp — change 

quot — summarize file system 


pads — user interface 
stdio — standard buffered input/output 


rev, revpag — reverse lines or 
p, more — 

tk -— 

drum — 

swapon — specify 


cross-reference lister .......:.ceeeeeeseeeeseeseeseeeeneeeeeeeee pxp, pxref — 


getpass — read a 

passwd — change login 

passwd — 

setpwent, endpwent, pwdecode — get 
cut, 
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NM — print Name List 2... cece eseeeeceteeeeseeeeneesceeeecseeeeeeteeeseeees 


nohup — run commands at low priority or. 
NON-lOCal OO oe. eeeeeeeeeeeeeeeeeteeseeeeeeee 
non-standard file system... 
nonstandard mux terminals... 
norm — integer math functions. 
normalize — map projections... 
not standard command programming language.. 
nrand, srand — random number generator .... 
nroff — text formatting and typesetting. 
nroff Or tof... eeeeeeeeseeeeeeeeeees 
null — data Sink... eeeeeeeeeeeeneeee 
number — convert Arabic numerals to 
number facts........cceeceeeseeseeeeeeeneees tas 
number, generate large PriMes..........ccceseseeeseeteeeeeeeeeeneees factor, 
number Generator oe. eee eee esses eeeseeeeeeseeescaeeeseeecseeesenseseeees 
numbers. eabeneeeans 
numbers intro, errno 
TIC DELS 25 eu cess cestascea desea te veuentessaineteniceias ate genlatend ance besten geterte ss 
numerals to English ; 
Object Liles sescscscacicitetceate vesvariessccbezsedsiercesedessxcaioissToiaistacesuaystlsensaiea 
OCtal Aus Pisisescisyssvadevceceessvassegslacsvecacudedentvens tees dav veiaeerscvelsoeeeeeeiaass 
ogre, sol, warp, sail — war games 


OOPS! process:Status) cw waesediosveieeas ives vues tesecsaaysetesescetveeusioeseey 
open — open for reading or writing.. 
open a datakit connection to a TEMOTE.........eeeeeeeeeeeteeeeteeteeeeeees 
open a pseudo-terminal file... eeeeseeeceecneeseeeeeeeseeseneeeeeeeees 
open a stream 
open file descriptor 
open for reading OF WIitiNg ...... eee eeeeeseeeceeeteeseeeeeeeseeeeneeseeeeeees 
opendir, readdir, telldir, seekdir, . 
Operating System svc ccécccsssaveececadleseeeeedsceabiegiecceaeinueoreaeaeenseiens 
Optimal’ CUPSOF MOTION..........cceeeeeseeseeeeseeseeeeteeseeeceeeneeaeeeeeeeseeaeees 
option letter from argv... 
OPHODS tier aseedeienane ce tiatecec ec ternnseneeaaneatormanieen nets 
orient, normalize — Map ProjectiONS...........:eccseseeeeeseeeteeteeseeees 
outfont, getfont — jerq text and font/.. 


OUT PU! CONVETSION esssisesscasssasiscessessessascescaatassatececastansasnests edssazeeres 
Output interpreter FOF JOT... ee eeeeseeeeeeseeseeeeeesceececseeeeeeeeeeseeees 
output package 
output to aps-5 
own, wait, alarm, sleep, nap, kbdchar,..........ceeeceeeeseeteeeeeeeeeeees 
owner and group of a file 
OWNET OF PTOUP ..2:u. ccs cosoassescescosstonsuces soo send gueasdnabowpetsconsnbetbeusessons 
OWErship ces Sec csscaea cates Can cass cecassaseg cusenabseuceciescucossensacecteiavasercerests 
P, More — paginate...... eee 
P, newproc, muxnewwind, newwindow, .. 
pack, pcat, unpack — compress and expand . 
package 
package... 
pads — user interface package... 
PAGES... cevsersveisaeeserecceteroeent 
paginate...... 
paginator for the Tektronix 4014 
Paging device... eects 

paging/swapping device........ 
paint — draw pictures in a layer... 
paper — list input on HP2621P printer 
pascal — language interpreter. 
pascal printer, profiler, and......... 
passwd — change login password 
passwd — password file .. 
password... 
password.... 
PASSWOL Pile ee oo: ot ce cecs seeneuten testes oot naceaner ei a tec oes pate cec oman aes 
password file entry... ../getpwuid, getpwnam, 
paste — rearrange columns Of data........cccecesseeseeeeneeeeeeeeeeeneees 


nm(1) 
clri(8) 
nice(1) 
setjmp(3) 
gmount(2) 
term(9.1) 
cos(9.3) 
map(3) 
ksh(1) 
rand(3) 
troff(1) 
tbl(1) 
null(4) 
number(1) 
arithmetic(6) 
factor(1) 
rand(3) 
atof(3) 
intro(2) 
seq(1) 
number(1) 
size(1) 
od(1) 
trek(6) 
twid(9.6) 
oops(8) 
open(2) 
tdkdial(3) 
ptopen(3) 
fopen(3) 
dup(2) 
open(2) 
directory(3) 
savecore(8) 
curses(3) 
getopt(3) 
stty(1) 
map(3) 
string(9.3) 
a(5) 
fread(3) 
printf(3) 
ecvt(3) 
proof(9.1) 
stdio(3) 
apsend(1) 
request(9.2) 
chown(2) 
chown(8) 
quot(8) 
p(1) 
newproc(9.2) 
pack(1) 
pads(9.5) 
stdio(3) 
pads(9.5) 
rev(1) 
p(1) 

tk(1) 
drum(4) 
swapon(8) 
paint(9.1) 
paper(1) 
pascal(1) 
pxp(1) 
passwd(1) 
passwd(5) 
getpass(3) 
passwd(1) 
passwd(5) 
getpwent(3) 
cut(1) 


blitmap — map plots and 
grep, egrep, fgrep — search a file for a 
lan Sa Ses itivesszecescsszsavsiacessadetatececssiagesestseensnesics aectetaizecte awk — 


pack, 
popen, 
11ranlib, 1 lreloc, 11size, 11 strip — 


uucheck — check uucp directories and 

mesg — 

ptx — 

EILOP MESSAGES Norciseviecesswpi ssid sts ediecssaviateeveesoneuistedeeapoveenens 
telno — retrieve from Bell Labs 

d202, daps, dean, tc — 


PICHUILES  s5.cevericcsiacere cinerea teat sae tele 


cip — 

ped, tped — 

ideal — troff preprocessor for drawing 
pic — troff preprocessor for drawing 
paint — draw 

mugs — convert gray-scale 


tee — 
town /- gazetteer of US 


blitmap — map 

hoc — interactive floating 

Rect, Rpt, display, Drect, Jrect -/.......ceeeeeseseteeeeeeeees Word, 
DASIO NEL G ccisse cesses. ca beveeudistes eevee sah seers Code, addr, bitblt, 
Iseek, tell — move read/write 

rectXrect, rectclip — arithmetic on 

PLOCESS 05a aR en eed etiernctonicccs omen ban chavenenciaanens 


POWET, SQUALE TOOL... eeeeeeeeseeeereteeseeeeeeseenes exp, log, log10, 
PUAN cea cacs syaeccbeasevsvecidesy sveacasdigelspos veiee ss teaaedsvenegseusenectes cb, 


be — arbitrary- 

mput, mmov, mcmp, mexp, mpow — multiple 

cpp — C language 

efl — extended Fortran language 

grap — pic 

ideal — troff 

pic — troff 

PTOSTAING vss cise, seavecscedosssenscscuves sosessdsesosdeaveseces oosevucacdesea de xstr — 
analyzer 


cb, pp — C program beautifier and 

=, ==— redo 

primes — factor a number, generate large 
types — 

cat — catenate and 

date — 


wwv — 
cal — 

pr— 

printf, fprintf, sprintf — 
banner, rot, rnd, bigp — 
pwd, where — 

nm — 

news — 

thinkblt, think — 

man — 

seq — 

pstat — 

ul, hp — 
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path finding ON a jer .....eceescecessesceseeecseeseeeeseeeeseeeeeeaeeseeeeseeaeees 
pattern ........... 
pattern-directed scanning and processing . 


pause — stop until signal... eee 
peat, unpack — compress and expand files 
pclose — initiate IO to/from a Process .........:esseseeeeeeteeseeeeeeneeee 
pdp11 support las, Llec, 111d, 11nm, 


ped, tped — picture editor... 
pen — doodle anywhere on the screen 
permissions file... ceeeeseeeeeeeeees 
permit or deny messages 

permuted index : 


perror, sys errlist, sys nerr—system. 
phone book.... 
phototypesetter filters... 
Pi, 3pi — Process INSPECtON........eeeeeeeeeeseeeeceteeteeseeeeeeseeeeeeeseeneees 
pic — troff preprocessor for drawin.........:eceeceseeseeseteeeeseeeeneeeeeee 
pic preprocessor for drawing graphs.. 
pick — pick arguments ...........ccceeeseeseeeeseeseeeeeeeseeseeeeaeeaeeeeeeseeaeees 
Picture drawing Program. ........ceeseeeeceseeseeeceeceeeeeeeeseeseeeeneeaeeeees 
picture editor 
PUG ES se3 5s scoa ccs cicnsseecevacse das ez duodecds ancesertuansaiedacdorascdeeisvayenbecneaten 
PICUUITES sa seeceesdsnisateetedoelseeeeoesd ay aaseenieas tinea vacueeenioteteiens 
pictures in a layer. 
PICUULES INO ICONS we ieee. egevseasts saseea dln Concer avndvadedartersvennesounvengendeaya 
pipe — create an interprocess channel............ccsscssseseeeseeseeeeeeeeeees 
pipe fitting 
places 
plot — graphics filters 0.0... cccecesescesceeeseeseeeeeeeseeseeeeaeeaeeeeeeneeaeees 
plot — graphics interface j 
plots and path finding On a jerq........ceeeeseeseeeeseeseeeeteeseeeeeeeseeneeee 
POMt Lan UA Ge vai. cere ss avcaaveescseseedeusescvavsiatseccissneesecksccouevastevecenes 
Point, Rectangle, Bitmap, Texture, Pt... 
point, rectf, screenswap, Segment, teXtULe .......... ce eeeeeeeeseeeeeeeeees 
POMEL 5 ssiatscs coescicaicezeevieiaatsiesseeetes cacreened visas oteetanlaereioaietaceiess 
points and rectangles ../raddp, rsubp, 
popen, pclose — initiate IO to/from au... eeeeeseeeteeteeeeeeeneeneees 
port — mathematical library for Fortran...........ccceceseseeeeeeneeneeee 
post — send mail to users by name 
postnews — submit netnews articles ........ ccc eeseeseeeeseeteeeeeeeeeneees 
pow, sqrt — exponential, logarithm, ............:eeeeseeeteeeeeseeeeneeeeeee 
pp —C program beautifier and pretty . 
ppt — convert to antique Media... eeeseceeeeseeeeeeneeseeeeeeeseeneeee 
Pr print fle v2.2: cee dea series eateea ea edieanitare onan 
precision arithmetic language .. Bes 
precision integer arithmetiC.........cceeeeeeeeeeeeteeeees et, 
preprocessor 
preprocessor 
preprocessor for drawing graphs..........cseceeeeeeseeeeeeeseeseeeeneeneeeees 
preprocessor for drawing PictUres.........ceccecceeeseeeeeeseeseeeeneeaeeeees 
preprocessor for drawing pictures... 
preprocessor for sharing strings in C . 
pret, trace — protocol compiler and . 
pretty printer... eens 

previous shell command 


..factor, factor, qfactor, 


print and set the date... ieee 
print and set the date from accurate clock. 
print calendar 


print file... 

print formatted output. 

print in large type... eeeeeeeereeee 26s 
print machine name and working directory . 
print name list 0.0... ce eeeeseeeeteeeeeeeeeees 


print news items... 
print on ThinkJet 
print sections of this manual .......... cc ceceseeeeeeseeseeeeneeeeeeeeeeneeneeee 
print sequences Of NUMDETS...........:ccceeseeseeeeeeeseeseeeeeeaeeeeeeeneeneees 
print system facts 0.0... eee 
print underlines on screen terminals .............cccscesceseeeeseeseeeeneeeeees 


blitmap(9.1) 
grep(1) 
awk(1) 
pause(2) 
pack(1) 
popen(3) 
11(8) 
ped(9.1) 
pen(9.6) 
uucheck(8) 
mesg(1) 
ptx(1) 
perror(3) 
telno(7) 
d202(1) 
pi(9.1) 
pic(1) 
grap(1) 
pick(1) 
cip(9.1) 
ped(9.1) 
ideal(1) 
pic(1) 
paint(9.1) 
mugs(9.1) 
pipe(2) 
tee(1) 
town(7) 
plot(1) 
plot(5) 
blitmap(9.1) 
hoc(1) 
types(9.5) 
bitblt(9.3) 
lseek(2) 
add(9.3) 
popen(3) 
port(3) 
post(1) 
postnews(1) 
exp(3) 
cb(1) 
bed(6) 
pr(1) 
be(1) 
mp(3) 
cpp(8) 
efl(1) 
grap(1) 
ideal(1) 
pic(1) 
xstr(8) 
trace(1) 
cb(1) 

=(1) 
factor(1) 
types(5) 
cat(1) 
date(1) 
wwv(1) 
cal(1) 
pr(1) 
printf(3) 
banner(6) 
pwd(1) 
nm(1) 
news(1) 
thinkblt(9.1) 
man(1) 
seq(1) 
pstat(8) 
ul(1) 


cb, pp — C program beautifier and pretty 


paper — list input on HP2621P 

Ipd — line 

Lister eevssesucenenitnh ares pxp, pxref — pascal 
tcan, xcan — interface to Canon laser- 

Ipr— line 


candest — canon laser 


nice — set program 


TICE ssc voteetih Gl Moouscts Wevee bel a voes th es eeteutees renice — alter 
nice, nohup — run commands at low 
/ 


reboot — bootstrapping 

exit — terminate 

fork — spawn new 

kill — send signal to a 

popen, pclose — initiate IO to/from a 
renice — alter priority of running 
cite — 

debug, getproc, getproctab — jerq 
init — 

/proc — 

getpid, getppid — get user, group, or 
hang - start a 

pi, 3pi- 

oops — 

ps — 

times — get 

wait — wait for 

kill — terminate a 

finddev — find 

ttyld — terminal 

awk — pattern-directed scanning and 
m4 — macro 

reboot — reboot system or halt 


monitor — prepare execution 

profil — execution time 

prof — display 

Icomp, Iprint — line-by-line 

pxp, pxref — pascal printer, 

cip — picture drawing 

end, etext, edata — last locations in 
units — conversion 

cb, pp —C 

uucico — file transport 

nice — set 

assert — 

lint-—aC 

c56 — terminal 

— Korn shell, the not standard command 
cd, wait — shell, the standard command 
lex — generator of lexical analysis 
make — maintain collections of 

struct — structure Fortran 

— preprocessor for sharing strings in C 
orient, normalize — map 

map — draw maps on various 


telnet — user interface to the telnet 
pret, trace — 


ptopen — find and open a 
doctor, tso — 


Word, Point, Rectangle, Bitmap, Texture, 
mul, div, eqpt, eqrect, inset, muldiv, 
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printer 
printer 
printer daemon 
printer, profiler, and cross-reference. 
printer spooler... 
printer spooler 
printers... eee 
printf, fprintf, sprintf — print. 
priority 
priority of running process by changing 
priority or immune to hangup 
proc — process file system 
procedures 
process .... 
process 
PYOCESS wee 
PYOCESS wee 
process by changing nice...... 

process citations in a document .. ae 
PYOCESS CONELOL.... ee eee eteeeeeeeeee /newwindow, tolayer, 
process control initialization 
process file system......... 

process identity........ 
process in stopped state.. 
process inspector 
process status 
process status . 
process times ade 
process to terminate 
process with extreme prejudice 
processes using a device 
processing 
processing language 
processor 
processor a 
prof — display profile data..... 
profil — execution time profile . 


profile data.. 
profiler sn cscrins cece ree 

profiler, and cross-reference lister.. 
program 
program 
program... she 
program beautifier and pretty printer 
program for the uucp system. 
program priority 
program verification 
program verifier 
program with data compression 
programming language 

programming language 

programs..... 
programs. 
programs..... 
programs..... 
projections 
projections......... 
proof — troff output interpreter for jerq. 
protocol 
protocol compiler and analyzer 
pS — process statuS............06. 
pseudo-terminal file . 
pstat — print system facts 
psychiatric consultation .... 
pt — interprocess I/O junctor files 
Pt, Rect, Rpt, display, Drect, Jrect —/ 
ptinrect, raddp, rsubp, rectXrect,/ 
ptopen — find and open a pseudo-terminal 
ptx — permuted index 
pubindex — find and insert literature ...........eeeseeeneeseeeeeeeneeeeeee 


cb(1) 
paper(1) 
Ipd(8) 
pxp(1) 
can(1) 
Ipr(1) 
candest(7) 
printf(3) 
nice(2) 
renice(8) 
nice(1) 
proc(4) 
reboot(8) 
exit(2) 
fork(2) 
kill(2) 
popen(3) 
renice(8) 
cite(1) 
newproc(9.2) 
init(8) 
proc(4) 
getuid(2) 
hang(1) 
pi(9.1) 
oops(8) 
ps(1) 
times(2) 
wait(2) 
kill() 
finddev(8) 
ttyld(4) 
awk(1) 
m4(1) 
reboot(2) 
prof(1) 
profil(2) 
monitor(3) 
profil(2) 
prof(1) 
Icomp(1) 
pxp(1) 
cip(9.1) 
end(3) 
units(7) 
cb(1) 
uucico(8) 
nice(2) 
assert(3) 
lint(1) 
c56(9.1) 
ksh(1) 
sh(1) 
lex(1) 
make(1) 
struct(1) 
xstr(8) 
map(3) 
map(7) 
proof(9.1) 
telnet(1) 
trace(1) 
ps(1) 
ptopen(3) 
pstat(8) 
doctor(6) 
pt(4) 
types(9.5) 
add(9.3) 
ptopen(3) 
ptx(1) 
refer(1) 


push, 
wwb, style, diction, 
ungetc — 


puts, fputs — 
putc, putchar, fputc, putw — 


putc, putchar, fputc, 

WOrKIN 8: ILEClOLY: es. c2.cs.esayeees casarsersvedeaeeasieiete saan eeeete Tava etenss 
/getpwuid, getpwnam, setpwent, endpwent, 

and cross-reference lister 
generate large primes........... 


eqpt, eqrect, inset, muldiv, ptinrect, 

worms, hanoi, 

number generator 
provide random exit code 


ranlib — convert archives 6 

rand, lrand, frand, nrand, srand — 

ar, 

WDPATTOS Cscasncced Saconcendseesseeausseecoctesceuiese ounevaegcssrosnsaccsveonvoneusees 


cp, 
/own, wait, alarm, sleep, nap, kbdchar, 


getpass — 

read — 

checknews, readnews — 

arff — 

directory Operations... cccecceesseeeeeeseeteeeeteeneeeeeeesees opendir, 
open — open for 

link, symlink, 

newsrc — information file for 

checknews, 

lseek, tell — move 

memory allocator... malloc, free, 
/wait, alarm, sleep, nap, kbdchar, revchar, 

cut, paste — 


Mail — send and 
mail — send or 
netnews — send or 
last — report 


utmp, wtmp — login 

/Point, Rectangle, Bitmap, Texture, Pt, 

rectclip — arithmetic on points and 

Basic Jerg/ ncse csomnsrcierimnthicesvens Code, addr, bitblt, point, 
/inset, muldiv, ptinrect, raddp, rsubp, 


re_comp, 
insert literature references in document «00.0.0... cece 
— pascal printer, profiler, and cross- 

pubindex — find and insert literature 

regular expression handlev............:ccccsssseeeeeseeseeeeseeseeeeneeaeeeees 
regcomp, regexec, regsub, 

re_comp, re_exec — 

regcomp, regexec, regsub, regerror — 

comm - select or 

intro — introduction to jerq- 

join — 

strip — remove symbols and 

calendar — 

uuxqt — execute 

push, pull — datakit 

track — selective 
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pull — datakit remote file copy 
punct — writers workbench 
push character back into input stream 
push, pull — datakit remote file copy. 
put a string on a stream......... 
put character or word on a stream.. 
puts, fputs — put a string on a stream. 
putw — put character or word on a stream 
pwd, where — print machine name and.... 
pwdecode — get password file entry 
pxp, pxref — pascal printer, profiler,.. 
qfactor, primes — factor a number,.... 
qsort — quicker sort. 
quiz — test your knowledge... 
quot — summarize file system ownership 
ra — DEC MSCP disks (RA60, RA80, RA81) 
raddp, rsubp, rectXrect, rectclip —/. fee ../div. 
rain — silly demos ie 
rand, lrand, frand, nrand, srand — random 
random — sample lines from a file or 
random libraries 
random number generator..... 
ranlib — archive and library maintainer. 
ranlib — convert archives to random...... 


rcp — copy. 
revchar, realtime, sendchar, sendnchars,/....... 
read — read from file 
read a password 
read from file. 
read news articles 
read RT11 files... cece eeeseeeeees 
readdir, telldir, seekdir, closedir 
reading or writing..... 
readlink — link to a file 
TEAUNEWS ......ceeeceeeeeseeeeeeeees 
readnews — read news articles........... 
read/write pointer... 
realloc, ialloc, calloc, cfree — main.... 

realtime, sendchar, sendnchars, kill, exit/ 
rearrange columns of data 
reboot — bootstrapping procedures...............+ 
reboot — reboot system or halt processor.. 
receive mail 
receive mail 
receive news articles ............. 
TeCent LOGINS... eeeceeeeeeseeeeeeeseeseeeeseeaceeeeeease 
re_comp, re_exec — regular expression. 
records 
Rect, Rpt, display, Drect, Jrect — basics 0... eeeceeeseeseeeeeeseeeeeee 
PECAN GOSH. ste cassie ecabedetetensaenseaete /raddp, rsubp, rectXrect, 
rectf, screenswap, segment, texture — 
rectXrect, rectclip — arithmetic on/. 
redo previous shell command 
re_exec — regular expression handler 
refer, lookbib, pubindex — find and 
reference lister......... 


.._Pxp, pxref 
refer, lookbib, 


regcomp, regexec, regsub, regerror — 
regerror — regular expression handler. 
regular expression handler... 

regular expression handler 
reject lines common to two sorted files. 
related software 
relational database operator... 
relocation bits 


remote command requests 
remote file copy 
TEMOLE LS COPY sicsescscsecsasseescatenscsensesccesctsisesarseeteasazensteiasteaseetess 


push(1) 
wwb(1) 
ungetc(3) 
push(1) 
puts(3) 
putc(3) 
puts(3) 
putc(3) 
pwd(1) 
getpwent(3) 
pxp(1) 
factor(1) 
qsort(3) 
quiz(6) 
quot(8) 
ra(4) 
add(9.3) 
worms(6) 
rand(3) 
random(1) 
ranlib(1) 
rand(3) 
ar(1) 
ranlib(1) 
rarepl(8) 
ratfor(1) 
rc(8) 

cp(1) 
request(9.2) 
read(2) 
getpass(3) 
read(2) 
readnews(1) 
arff(8) 
directory(3) 
open(2) 
link(2) 
newsrc(5) 
readnews(1) 
Iseek(2) 
malloc(3) 
request(9.2) 
cut(1) 
reboot(8) 
reboot(2) 
Mail(1) 
mail(1) 
netnews(1) 
last(1) 
regex(3) 
utmp(5) 
types(9.5) 
add(9.3) 
bitblt(9.3) 
add(9.3) 
=(1) 
regex(3) 
refer(1) 
pxp(1) 
refer(1) 
regexp(3) 
regexp(3) 
regex(3) 
regexp(3) 
comm(1) 
intro(9) 
join(1) 
strip(1) 
calendar(1) 
uuxqt(8) 
push(1) 
track(1) 


uucp, uulog, uuname — unix to unix 

ropy — 

dcon, ndcon, rx, rogin, rsh — 

dkerror — open a datakit connection to a 
mkdir, rmdir — make or 

unlink — 

mount, umount — mount or 

deroff — 

gmount — mount or 

strip — 

rm, rmdir — 

mv — move or 

process by changing Nice... cceeccecseeseeeeeeeseeseeeeseeseeeceeeaeeeees 
system consistency check and interactive 
uniq — report 

rarepl, rarct — 

iostat, load, dkstat — 

last — 

uniq — 

vmstat — 

fseek, ftell, rewind — 

kbdchar, revchar, realtime, sendchat,/............c:ccccccssceeseeesseeeee 
deroff — remove formatting 

jioctl — jerq ioctl 

sendnchars, kill, exit — jerq I/O 

uuxqt — execute remote command 
windows, jps, 

byteyears — time-space product for file 
telno — 


fseek, ftell, 
mail — address conventions and 
strpbrk, strspn, strcspn, strtok, index, 


mkdir, 


rm, 


mesg, 
banner, rot, 

dcon, ndcon, rx, 

adventure, zork, aardvark, 

— exponential, logarithm, power, square 
chdir, chroot — change working or 


banner, 

/Rectangle, Bitmap, Texture, Pt, Rect, 
dcon, ndcon, rx, rogin, 

/eqrect, inset, muldiv, ptinrect, raddp, 
arff — read 


mail — address conventions and rewrite 

server — 
nice, nohup — 
dcon, ndcon, 


trek, ogre, sol, warp, 


savecore — 
brk, 
mugs — convert gray- 


awk — pattern-directed 

alarm — 

uusched — uucp file transport 

boggle, hangman, 

clear — clear terminal 

pen — doodle anywhere on the 

ruler — measure things on the 

MOLOM: worvctelcsscereseteesserageteigseseivecstevense Pek caomwensinent ce curses — 
blitblt — make hard copy of 

ul, hp — print underlines on 
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remote file copy 
remote file copy for arpa internet 
remote login and execution... 
remote server 
remove a directory .. 
remove directory entry 
remove file system 
remove formatting requests............... 
remove non-standard file system... 
remove symbols and relocation bits.. 
remove (unlink) files........... cece 
rename files and directories .. 
renice — alter priority of running 
repair 
repeated lines in a file 
replace bad blocks on MSCP disks... 
report I/O and CPU statistics ...... 
report recent logins .. 
report repeated lines in a file. 
report virtual memory statistics......... 
reposition a stream 
request, own, wait, alarm, sleep, nap, 
requests ... 
requests ... 
requests 
requests 
reshape — create and initialize windows 
residency 
retrieve from Bell Labs phone book 
rev, revpag — reverse lines or pages............... 
rewind — reposition a stream 
rewrite rules wo... 
rindex — string operations..... 
rk — RK11/RKO7 disk driver. 
rm, rmdir — remove (unlink) files... 
rmdir — make or remove a directory 
rmdir — remove (unlink) files...... 
rmdir — unlink directory 
rmesg — message line discipline modules 
rnd, bigp — print in large type... 
rogin, rsh — remote login and execution... 
rogue, wump — dungeon-exploration games......... 
TOO secissancisesacsscisscescosasiaysazectetevsaseeeees? exp, log, log10, pow, sqrt 
root directory. : 

ropy — remote file copy for arpa internet.. 
rot, rnd, bigp — print in large type 
Rpt, display, Drect, Jrect — basic jerq/ 
rsh — remote login and execution 
rsubp, rectXrect, rectclip — arithmetic/. 
RULE AICS 33. ce cio etude 


run anonymous command on another machine. 
run commands at low priority or immune to.. 
rx, rogin, rsh — remote login and 
sa, accton — system accounting 
sail — war games 
sample lines from a file or provide random 
save a core dump of the operating system .. 
sbrk, break — change core allocation..... 
scale pictures into iCOMS ........eeseeeeeeseeseeeeeeee 
scanf, fscanf, sscanf — formatted input 
scanning and processing language... 
schedule signal after specified time 
scheduler 


screen... 
screen 
screen functions with ‘optimal’ cursor 
screen image 
SCreen terminals 23 séexscsveves sivesescensesasaseassasesnseaeescvannasesvestssiearecexss 


uucp(1) 
ropy(1) 
dcon(1) 
tdkdial(3) 
mkdir(2) 
unlink(2) 
mount(2) 
deroff(1) 
gmount(2) 
strip(1) 
rm(1) 
mv(1) 
renice(8) 
fsck(8) 
uniq(1) 
rarepl(8) 
iostat(1) 
last(1) 
uniq(1) 
vmstat(8) 
fseek(3) 
request(9.2) 
deroff(1) 
jioctl(9.4) 
request(9.2) 
uuxqt(8) 
windows(9.1) 
byteyears(1) 
telno(7) 
rev(1) 
fseek(3) 
mail(7) 
string(3) 
rk(4) 
rm(1) 
mkdir(2) 
rm(1) 
rmdir(8) 
mesg(4) 
banner(6) 
dcon(1) 
adventure(6) 
exp(3) 
chdir(2) 
ropy(1) 
banner(6) 
types(9.5) 
dcon(1) 
add(9.3) 
arff(8) 
tuler(9.1) 
mail(7) 
server(1) 
nice(1) 
dcon(1) 
sa(8) 
trek(6) 
random(1) 
savecore(8) 
brk(2) 
mugs(9.1) 
scanf(3) 
awk(1) 
alarm(2) 
uusched(8) 
boggle(6) 
clear(1) 
pen(9.6) 
tuler(9.1) 
curses(3) 
blitblt(9.1) 
ul(1) 


Code, addr, bitblt, point, rectf, 

docgen — generate a document from a 

rc — boot 

CistriDUtion.........cceeceeeeseeeeeeeseeseeeeeeeeeeeeeeseeeeees mkpkg, inspkg, 
grep, egrep, fgrep — 

xsend, xget, enroll — 

man — print 


opendir, readdir, telldir, 
/addr, bitblt, point, rectf, screenswap, 


SOLE FILES: 2a, .: etveressesavcevestecatareevesereguee seeeetea samen getees comm — 
menuhit — present user with menu and get 

track — 

Mail — 

post — 

mail — 

netnews — 

kill -— 

apsend — 

/sleep, nap, kbdchar, rcvchar, realtime, 


dkmgrnak, dkfilename — establish datakit 
faced — network face 

— open a datakit connection to a remote 
Machines ee sie Lieve wes sesininaatasneceliasesie 
library, bellcat — bell labs library 

ct — call terminal (and start a 

ascii — map of ASCII character 

umask — 

touch — 

utime — 

apply — apply a command to a 

nice — 

getty — 

tset — 

stty — 

tabs — 

date — print and 

wwvy — print and 

stime, settod — 

setuid, setgid — 


getfsent, getfsspec, getfsfile, 
setuid, 
getgrent, getgrgid, getgrnam, 


— system calls to be avOided ..... eee eseeeeeeseeeeteeteeseeeeneeneeeees 
getpw, getpwent, getpwuid, getpwnam, 
stime, 


arithmetic functions: absolute/ ............cccccsccesseeseeeseeensees abs, 
command programming language ..........cscseseeeeseeteeeeeeeeeeneeee 
xstr — preprocessor for 

mcs — macros for formatting cover 


=, == — redo previous 

system — issue a 

programming language..........cceeseeeeeseereeeeeeeseeees ksh — Korn 
VAN GUAGE. a asccecelcatalees oxccceesssedecceesssaberdecécseapereeses sh, cd, wait — 


nap — suspend execution for a 
face — 

vis — 

netstat — 


/arithmetic functions: absolute value, 
login — 
pause — stop until 


alarm — schedule 
kill — send 
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screenswap, segment, texture — basic jerq/ ........:ccseseeeeeeseeeeee 
SCIPtiescaiesdaesesectes 
script... oa 
seal, unseal — automatic software 
search a file for a pattern 
secret Mail... eee 
sections of this manual... 
sed — stream editor...... 
seekdir, closedir — directory operations 
segment, texture — basic jerq graphics/. 
select — synchronous I/O multiplexing.. 
select or reject lines common to two.. 
SCL ECHON in. seecesensavedeeredes vetcvecvesssesede 
selective remote file copy . 
send and receive mail........ 
send mail to users by NAM .........eeeeeceeeeseeseeeeteeseeeceeeseeseeeeeeeseeees 
send or receive Mail ........ ce eeeeeeecseeseeeeseeseeseeeeaeesceeceecseeeeeeeeeeaeeees 
send or receive news articles. 
send signal to a PrOCeSS........secceseseeseeseseeseesceeescesceeceecseeseeeeeeeseeees 
send troff output to aps-5 oc eeseeseeceseeseeseeeeeesceeceecseeseeeeeeeaeeees 
sendchar, sendnchars, kill, exit — jerq/.. 
seq — print sequences Of MUMDETS «0.0.0... ceceeeseeeeeeeeeeseeeeeeneeeees 
SOIVED seteecdiieistindsiaastenideneeiiaseeeded dkmgr, dkmgrack, 
server... 
SOLVED. ccevasetauyuize sas evcuvseceatoetavietresatbawmneterauitenae tiered 

server — run anonymous command on another «0... 
services 
session), 


set file creation mode mask... 
set file modification date.........cceccccseeseeseeseeeeeeseeseeeeeeseeseenseesees 
SOt FILS AMES 2ces!sicadivecdssvcsveccccanaveapienecooanesacandeadsveevucsssaesseesbeceedies 
set of arguments... 
SEL PLO PLAN PLIOTILY scc.csessvevseccscesssedecescaseaseveee ieveviovacecccdensvaesenseness 
Set terminal MOG sis iscees scisvassaeccessicesceuzevss sassedgeseacsanicaiei vig sevhacacaess 
set terminal modes.. 
Set terminal OptlOns.s.:.scccvecceccssnsenetcsccseeadacensen corvineaceraoveveateceeeney 
Set terminal tabs ciccsccqescvesvsissectecsccssceusevsasasatagesenassnaceies say vevaeeesens 


setbuf — assign buffering to a stream... eeseeseeeeseeseeeeneeeeeeees 
setfsent, endfsent — get file SySteM/..........cceceseseeceeeeseeseeeeteeseeees 
setgid — set user and group ID 
setgrent, endgrent — get group file entry ......... ee eeseeseeeeeeeeeeees 
setjmp, longjmp — non-local Goto ...... ee eeeceeeseeseeeeeeeeeseeeeteeseeees 
setkey, encrypt — DES encryption 
setpgrp, vfork, vadvise, vlimit, VsWapON ..........:eceeeseeeeeeteeeeees 
setpwent, endpwent, pwdecode — get/........e eects 
settod — set time ..... eee 
setuid, setgid — set user and group ID 
sgn, gcd, lcm, min, max — integer... 
sh, cd, wait — shell, the standard . 
sharing strings in C programs..... 
SheetSissbssseatateeciiasieVanies 
shell command. 
shell command... 

shell, the not standard command........ 

shell, the standard command programming. 
ship — automatic software distribution... 
short interval oo... eee 
show faces on jerq.......... 
show invisible characters... 
show network status for ARPA internet... 
showg — state of stream I/O system...... 
sign, greatest common divisor, least/. 
sign on.... 


signal — catch or ignore Signals ..........ccesecseeseeseeeeeeeeeeeneeteeseeees 


signal after specified time 
Signal tO a PLOCESS .avcssceviasssasssseenssscessscesdisesa saree sscavezssotevsasemsaateess 


bitblt(9.3) 
docgen(1) 
rc(8) 
asd(8) 
grep(1) 
xsend(1) 
man(1) 
sed(1) 
directory(3) 
bitblt(9.3) 
select(2) 
comm(1) 
menuhit(9.3) 
track(1) 
Mail(1) 
post(1) 
mail(1) 
netnews(1) 
kill(2) 
apsend(1) 
request(9.2) 
seq(1) 
dkmer(3) 
faced(9.5) 
tdkdial(3) 
server(1) 
library(7) 
ct(1) 
ascii(7) 
umask(2) 
touch(1) 
utime(2) 
apply(1) 
nice(2) 
getty(8) 
tset(1) 
stty(1) 
tabs(1) 
date(1) 
wwv(1) 
stime(2) 
setuid(2) 
setbuf(3) 
getfsent(3) 
setuid(2) 
getgrent(3) 
setjmp(3) 
crypt(3) 
deprecated(2) 
getpwent(3) 
stime(2) 
setuid(2) 
arith(3) 
sh(1) 
xstr(8) 
mcs(7) 
=(1) 
system(3) 
ksh(1) 
sh(1) 
ship(1) 
nap(2) 
face(9.1) 
vis(1) 
netstat(8) 
showq(8) 
arith(3) 
login(8) 
pause(2) 
signal(2) 
alarm(2) 
kill(2) 


signal — catch or ignore 


functions...... 
trigonometric functions 


null — data 


Ess 6d (6127 Ge gO request, own, wait, alarm, 


spitbol — 

sno — 

snocone — 

intro — introduction to jerq-related 
mkpkg, inspkg, seal, unseal — automatic 
ship — automatic 

trek, ogre, 

qsort — quicker 

tsort — topological 


— select or reject lines common to two 
look — find lines in a 

coreid — identify 

byteyears — time- 

fork — 

eqnchar — 

mknod — make a directory or a 
mknod — build 

alarm — schedule signal after 

swapon — 


split, fsplit — 

frexp, ldexp, modf — 

uucleanup — uucp 

xcan — interface to Canon laser-printer 
Ipr— line printer 

visi — mathematical 

printf, fprintf, 

SQUALE TOOL... eee eee ce eseeeeeeseeseteeseteeees exp, log, log10, pow, 
cos, sin, atan2, 

sqrt — exponential, logarithm, power, 
rand, lrand, frand, nrand, 

scanf, fscanf, 


stdio — 

ksh — Korn shell, the not 

sh, cd, wait — shell, the 

gmount — mount or remove non- 
hang — 

ct — call terminal (and 


hang — start a process in stopped 
showg — 

fstab — 

iostat, load, dkstat — report I/O and CPU 
sysmon, vismon — display system 
vmstat — report virtual memory 
oops — process 

ps — process 

stat, Istat, fstat — get file 

netstat — show network 

feof, ferror, clearerr, fileno — stream 
uustat — uucp 

fd, stdin, stdout, 
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SUSTIALS sc ahocg coc ccc ety seeyesceseunsch cused shsuetetedeoseuceugenisdesuncagnecenisseecengainan 
sin, atan2, sqrt, norm — integer math.. 
sin, cos, tan, asin, acos, atan, atan2 —. 
sinh, cosh, tanh — hyperbolic functions. 


size — size of an object file 
sky — calculate ephemerides............ 
sleep — suspend execution for an interval . 
sleep — suspend execution for an interval . 
sleep, nap, kbdchar, rcvchar, realtime,.. 
snake, worm — display chase games... 
sno — Snobol language interpreter... 
Snobol language compiler........ 
Snobol language interpreter .. 
snobol with syntactic sugar... 
SOL Wael styh acct cei ckesst adie toetan us dere iuwsecateblcespasteavevouceeusceesaaey 
software distribution 
software distribution 


SOP sstssscasocient Sasteoraieccesstoanvencuedh seaueensaseatacrettedaeteaca eas tataareeaeettes 
SOP aac ciencunanareiess 

sort — sort and/or merge files.........ccceeceseeseeeeeeeteeeeeeeteeseeneeeaeeeees 
SOLted MES Hci veasive elec sveeeeesdasvsvabetaayiecdigesenns ee comm 


sorted list 
SOUTCE Of COPE AMA LE 2.7. covatceneeasnsenverccceser svvientecertoraencecenrsdenteqtestea 
space product for file residency ..........eseeeseeseseeeeceeeeeeseeeeteeseeees 
spawn new process 
special character definitions for CQN..........:eceseseeeeeeseeeeeeteeeeeees 
Special AUS ese. is. sh veavcett evevectecevstepaieresie nevaurcieammanweconteveatecteatsy 
special file.. 
specified time 
specify paging/swapping AeViCe .........seeeseeeseececeeeeeeseeeeeeeseeees 
spell — find spelling errors. 
spitbol — Snobol language compiler... cceceseseeeeeeseeeeneeeeeees 
Split:a file: Into PIECES sisi.ss.csscceccassegstevseseasviasancdaetsisiseaeeviaveniaiecctes 
split into mantissa and exponent. 
Spool directory Clean-Up... cceeeeeeseeceseeseeseeeeeesceeceecseeeeeeteeeseees 
SPOOL OL iss zis des veesesed sssnezseievaccasetentssasenteaneess 

spooler.... 
SPreadShe ct siccsc.c svvesccsevcasgadcuccesoeetercenseveiaincceusapeasssscasvaesseeceiees 
sprintf — print formatted OUtpUt...... eee eeeeeneeteeeeeeeeeeeeeeeeeseeees 
sqrt — exponential, logarithm, power, 
sqrt, norm — integer math FUNCTIONS... ee eteseeeeeeeteeeeeeteeeeeeees 
SQUALE TOOL. cecvess veces ccomsecesnssvesssnevedeicnsensenese exp, log, log10, pow, 
srand — random number generator .. ts 
sscanf — formatted input COMVETSION .........ceceeeseeseeeeseeeeeeeeeeseeees 
stab — symbol table types ..........cesceseeeeseeeeeceeceeeeceeeseeseeeeneeaeeeees 
standard buffered input/output package... 
standard command programming language ..........:.esseeseeeeeeeeeees 
standard command programming language ............scseeseeeeeeeeeees 
standard file system..........ceeeeseeeeeeeees 

start a process in stopped state. 
Start @ SESSION)........ccccsceeseeeeees 
stat, Istat, fstat — get file status . 


state of stream I/O system Sse 

static information about the filesystems 
statistics 
statistics. 
statistics. 
status... 
status... 


status for ARPA internet... 
status inquiries «0.0... 
status inquiry and job control... 
stderr, tty — file descriptor files ....... 

stdio — standard buffered input/output .. 
Sti Iter Preven sica ccc casiaesceedisese seus cxgsee ses deacantcn convteaveca vvevennsceeets 
stdout, stderr, tty — file descriptor ..........cececeseescesceeeseeeeeeeteeseeees 
stime, settod — set time 
Stop umtil Signal. seicsssiccescssssscsevessessessascescatassaysecsastansasteossvaascicterss 


signal(2) 
cos(9.3) 
sin(3) 
sinh(3) 
null(4) 
size(1) 
sky(7) 
sleep(1) 
sleep(3) 
request(9.2) 
snake(6) 
sno(1) 
spitbol(1) 
sno(1) 
snocone(1) 
intro(9) 
asd(8) 
ship(1) 
trek(6) 
qsort(3) 
tsort(1) 
sort(1) 
comm(1) 
look(1) 
coreid(1) 
byteyears(1) 
fork(2) 
eqnchar(7) 
mknod(2) 
mknod(8) 
alarm(2) 
swapon(8) 
spell(1) 
spitbol(1) 
split(1) 
frexp(3) 
uucleanup(8) 
can(1) 
Ipr(1) 
visi(1) 
printf(3) 
exp(3) 
cos(9.3) 
exp(3) 
rand(3) 
scanf(3) 
stab(5) 
stdio(3) 
ksh(1) 
sh(1) 
gmount(2) 
hang(1) 
ct(1) 
stat(2) 
hang(1) 
showq(8) 
fstab(5) 
iostat(1) 
sysmon(9.1) 
vmstat(8) 
oops(8) 
ps(1) 
stat(2) 
netstat(8) 
ferror(3) 
uustat(1) 
fd(4) 
stdio(3) 
jx(9.1) 
fd(4) 
stime(2) 
pause(2) 


hang — start a process in 

galloc, gfree, garbage — 

database SUDrOUTINES ..........c cc ceceeseceseeeeseeeteeees dbminit, fetch, 

apnews, ap.keys — present AP wire 

strncpy, strlen, strchr, strrchr,/.... 
fclose, fflush — close or flush 

fopen, freopen, fdopen — open a 

fseek, ftell, rewind — reposition a 

fgetc, getw — get character or word from 

gets, fgets — get a string from a 

fputc, putw — put character or word on a 

puts, fputs — put a string on a 

setbuf — assign buffering to a 

ungetc — push character back into input 


connld — unique 

ioctl, stty, gtty — miscellaneous 

sed — 

stream — 

showg — state of 

feof, ferror, clearerr, fileno — 

getfont — jerq text and font operations...........cceceeseeeeeeeeeeeeee 
gets, fgets — get a 

puts, fputs — put a 

strspn, strcspn, strtok, index, rindex — 
xstr — preprocessor for sharing 


DUS. sascoveiasescs savvsravestuvencteacstsasstsssadaasiscovetedessgseeessaiestisenesestetsasa> 
basename, dirname — 

/strncat, stremp, strncmp, strepy, strncpy, 

text and font operations... cceeeeseereeeeeeeeeeees string, defont, 
OPCratlONns ws. ateiee iain thesealai mi neaeetees ioctl, 


wwb, 


...add, 
postnews — 
su — 


muldiv, ptinrect, raddp, rsubp,/. 


sync — update the 

update — periodically update the 
sync — update 

11reloc, 11size, 11strip — pdp11 
nap — 

sleep — 

sleep — 


stab — 


strip — remove 
link, 


select — 
snocone — snobol with 
cyntax, cem — C 


messages 
statistics .......... 


perror, sys_errlist, 

— mount or remove non-standard file 
mkbitfs, mklost+found — construct a file 
mount, umount — mount or remove file 
mount, umount — mount and dismount file 
netfs — network file 

/proc — process file 

— save a core dump of the operating 
showg - state of stream I/O 

— file transport program for the uucp 
who, whois — who is on the 


sa, accton — 
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stopped state 
storage allocation with garbage collection 
store, delete, firstkey, nextkey — 
SLOTIES x. ose.scoscs cst oeiuns cangvensseengusetesnnnes 
strcat, strncat, strcmp, strncmp, strcpy,. 
stream 
stream 
stream 
stream... 
stream 
stream 
stream 
stream 
stream 
stream — stream I/O control calls 
stream connection 
stream control operations.. 
stream editor............. 
stream I/O control calls.. 
stream I/O system 
stream status iNQUITICS......... eee eeeeeeeeeeeeeeeeeeee 
string, defont, strwidth, infont, outfont, 
string from a stream. 
string on a stream. 
string operations 
strings in C programs 
strip — remove symbols and relocation . 
strip filename affixes 
strlen, strchr, strrchr, strpbrk, strspn,/ 
struct — structure Fortran programs 
strwidth, infont, outfont, getfont — jerq 
stty — set terminal options 
stty, gtty — miscellaneous stream control 
style, diction, punct — writers workbench 
su — substitute user id temporarily .... 
sub, mul, div, eqpt, eqrect, inset, 
submit netnews articles............ 
substitute user id temporarily... 
sum — sum and count blocks in a file 
super block 
super block.. 
super-block.. 
support llas, llec, 111d, 11nm, 1 lranlib, 
suspend execution for a short interval or 

suspend execution for an interval... 
suspend execution for an interval 
swab — swap byte... cceeceeeseeseeeeneeeeeeeeeenes 
swapon — specify paging/swapping device... 
symbol table types 
symbols and relocation bits... 
symlink, readlink — link to a file 
sync — update super-block. 
sync — update the super block 
synchronous I/O multiplexing 
syntactic sugar. 
syntax checker. 
syscall — indirect system call 
sys_errlist, sys_nerr — system error 
sysmon, vismon — display system.. 
sys_nerr — system error messages .. 


gmount 
....mkfs, 


system 
system — issue a shell command 
SYSLEM ACCOUNUUNG sas: ccsscasssacssvessessessascesciatassayceesestaasasteossvaasccteres 


hang(1) 
galloc(3) 
dbm(3) 
apnews(7) 
string(3) 
fclose(3) 
fopen(3) 
fseek(3) 
getc(3) 
gets(3) 
putc(3) 
puts(3) 
setbuf(3) 
ungetc(3) 
stream(4) 
connld(4) 
ioctl(2) 
sed(1) 
stream(4) 
showq(8) 
ferror(3) 
string(9.3) 
gets(3) 
puts(3) 
string(3) 
xstr(8) 
strip(1) 
basename(1) 
string(3) 
struct(1) 
string(9.3) 
stty(1) 
ioctl(2) 
wwb(1) 
su(8) 
add(9.3) 
postnews(1) 
su(8) 
sum(1) 
sync(8) 
update(8) 
sync(2) 
11(8) 
nap(2) 
sleep(1) 
sleep(3) 
swab(3) 
swapon(8) 
stab(5) 
strip(1) 
link(2) 
sync(2) 
sync(8) 
select(2) 
snocone(1) 
cyntax(1) 
syscall(2) 
perror(3) 
sysmon(9.1) 
perror(3) 
gmount(2) 
mkfs(8) 
mount(2) 
mount(8) 
netfs(8) 
proc(4) 
savecore(8) 
showq(8) 
uucico(8) 
who(1) 
system(3) 
sa(8) 


syscall — indirect 
intro, errno — introduction to 
vfork, vadvise, vlimit, vswapon — 


config — 
icheck, dcheck, ncheck — file 
TOPALT. se sessccscssesseisedasctessereistenssistatecanstiegepeateaperinaee fsck — file 


types — primitive 

getfsfile, setfsent, endfsent — get file 
dmesg — 

perror, sys_errlist, sys_nerr— 
pstat — print 

reboot — reboot 

quot — summarize file 

sysmon, vismon — display 

mtab — mounted file 

filsys, flblk, ino — format of file 
mtab — mounted file system 
stab — symbol 

tbl — format 

tabs — set terminal 


trigonometric FUNCTIONS 00.0... ee eeeeeeeeeeeceeeeeeeseeeeneeneees sin, cos, 
sinh, cosh, 
mt — identify and manipulate magnetic 


tar — 

MAGNetIC taper. cificecdeiieaseeseilieasceeesdaavesdeeciduslsvansecsiduaveceereies 
d202, daps, dean, 

laser-printer SpoOle? .........ceseceeseseeeeeeeteeeeeeeeee can, bean, dean, 


tcp_listen, tcp_accept, tcp_rcmd — 


tk — paginator for the 


lseek, 
operations opendir, readdir, 


protocol .. 


config — system configuration 
su — substitute user id 


isatty, ttyslot — find name of a 

ct — call 

termcap — 

ptopen — find and open a pseudo- 
/tgetflag, tgetstr, tgoto, tputs — 
ttys — 

getty — set 

tset — set 

tty — get 

stty — set 

ttyld — 

c56 — 

clear — clear 

tabs — set 

term — nonstandard mux 

ul, hp — print underlines on screen 


wait — wait for process to 
kill- 
exit — 


newer — 
quiz — 

strwidth, infont, outfont, getfont — jerq 

ed — 

jim, jim.recover — 

ex, Vi- 

troff, nroff — 

/bitblt, point, rectf, screenswap, segment, 

THECUS. A Gale Gece ennaons Word, Point, Rectangle, Bitmap, 
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system call 
system calls and error numbers......... 
system calls to be avoided 
system configuration template files 
system consistency check 
system consistency check and interactive 
system data types 
system descriptor file entry 
system diagnostic message 
system error messages........... 
system facts 
system or halt processor 
system ownership 
system statistics. 
system table. 
system volume 


table types... 
tables for nroff or troff 
LADS 3 vez .cssucaeted siaeeeeeietone ea 
tail — deliver the last part of a file 
tan, asin, acos, atan, atan2 -.. 
tanh — hyperbolic fUNCtiONS..........ceeecseeseeceeeeteeseeeeeeeaeeeeeeseeneees 


tape archiver... 
tape, mt — identify and manipulate.... 
tar — tape archiver 
tbl — format tables for nroff or troff... 
tc — phototypesetter filters 
tcan, xcan — interface to Canon 
tcp operations 
tee — pipe fitting 
Tektronix 4014 
tel — local and private telephone books.......... 
tell — move read/write pointer........... 
telldir, seekdir, closedir — directory 
telnet — user interface to the telnet... 
telno — retrieve from Bell Labs phone 
template files............ 
temporarily 
term — nonstandard mux terminals... 
termcap — terminal capability data base 
derminal saissteccssisssstesstsetcarsstestevscssseeessseszcavs. ttyname, cttyname, 
terminal (and start a session) 
terminal capability data base. 
terminal file 
terminal independent operation ‘foutines Vaseeeds 
terminal initialization data 
terminal mode 
terminal modes.. 
terminal name 
terminal options «0.0.0... eee 
terminal processing... 
terminal program with data compression 
terminal screen 
terminal tabs............. 
terminals... 
terminals.. 
terminals — conventional names.. 
CETMUM ALE vccccscatishevecccledavsteeceieesanns 
terminate a process with extreme prejudice... 
terminate Process «0.0... 
test — condition command. 
test file modification dates 
test your knowledge....... 
text and font operations .... 
text editor... 

text editor 
text editor... 
text formatting and typesetting 
texture — basic jerq graphics functions 
Texture, Pt, Rect, Rpt, display, Drect, .........cceseseseeseeeeeeseeneees 


syscall(2) 
intro(2) 
deprecated(2) 
config(5) 
icheck(8) 
fsck(8) 
types(5) 
getfsent(3) 
dmesg(8) 
perror(3) 
pstat(8) 
reboot(2) 
quot(8) 
sysmon(9.1) 
mtab(5) 
filsys(5) 
mtab(5) 
stab(5) 
tbl(1) 
tabs(1) 
tail(1) 
sin(3) 
sinh(3) 
tape(1) 
tar(1) 
tape(1) 
tar(1) 
tbl(1) 
d202(1) 
can(1) 
tcp(3) 
tee(1) 
tk(1) 

tel(7) 
lseek(2) 
directory(3) 
telnet(1) 
telno(7) 
config(5) 
su(8) 
term(9.1) 
termcap(5) 
ttyname(3) 
ct(1) 
termcap(5) 
ptopen(3) 
termcap(3) 
ttys(5) 
getty(8) 
tset(1) 
tty(1) 
stty(1) 
ttyld(4) 
c56(9.1) 
clear(1) 
tabs(1) 
term(9.1) 
ul(1) 
term(7) 
wait(2) 
kill) 
exit(2) 
test(1) 
newer(1) 
quiz(6) 
string(9.3) 
ed(1) 
jim(9.1) 
vi(1) 
troff(1) 
bitblt(9.3) 
types(9.5) 


tgoto, tputs — terminal independent/............eeeeseeeseeeeeeeeeneeee 
thinkblt, 

alarm — schedule signal after specified 

at — execute commands at a later 

stime, settod — set 

time, ftime — get date and 


profil — execution 

asctime, timezone — convert date and 
times — get process 

utime — set file 


byteyears — 
ctime, localtime, gmtime, asctime, 


mktemp, 
.P, newproc, muxnewwind, newwindow, 


CASG Ss seissecscrsceswevexsshgecesstesseeecsstiedsvadeiaeasodsash avesnia aeedeces anata Ges 
tsort — 

tolower, 

weather — conditions and forecast by 

ped, 

/tgetnum, tgetflag, tgetstr, tgoto, 

pret, 

atc — air 

tr- 

icont, iconc — Icon language 

bread, bdelete, bwrite — compressed B- 

ftw — file 

sin, cos, tan, asin, acos, atan, atan2 — 

tbl — format tables for nroff or 

Cy PeSettin Oss sieiestehasuaee adeseiiedsuensaeivemiia ences & 


proof — 
apsend — send 
ideal — 

pic — 


doctor, 


fd, stdin, stdout, stderr, 


name: of a: terminal «.i01.4.<s.:scevesssseeisesasssecsisessierstaseereaesessssessaciss 
ttyname, cttyname, isatty, 


banner, rot, rnd, bigp — print in large 
file — determine file 

stab — symbol table 

types — primitive system data 

Drect, Jrect — basic jerq graphics data 


monk, monksample — 

man — macros to 

eqn, neqn, checkeq — 

font — 

troff, nroff — text formatting and 

udp_ connect, udp listen, udp datagram — 


Lerma ssc dsgessexscazedsdescagacesesenceiatacedesesesiieeeapeeeed saadedeeactheaees 
mount, 
mount, 

ul, hp — print 

SUC cos sssuccxcoseacisesaacoslesgesusesessesay sucea sewer guansea cise petaseceetecgcessoyed 
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tgetent, tgetnum, tgetflag, tgetstr, 
think — print on ThinkJet 


time — time a command 
time, ftime — get date and time 
time profile 
time to ASCII 


times — get process times 
time-space product for file residency 
timezone — convert date and time to ASCII... 
tk — paginator for the Tektronix 4014 
tmpnam — make a unique file name.. 
tolayer, debug, getproc, getproctab -.... 
tolower, toupper — force upper or lower. 
topological sort 
touch — set file modification date 


town /- gazetteer of US places . 
tped — picture editor 
tputs — terminal independent operation/ 
tr—translate CharacterS..........ceeeeeeee 
trace — protocol compiler and analyzer 
track — selective remote file copy. 
traffic controller 
translate characters 
translator and compiler. 
tree subroutines 
tree walk. 
trek, ogre, sol, warp, sail — war games.. 
trigonometric functions.. 


troff, nroff — text formatting and 
troff output interpreter for jerq. 
troff output to aps-S ....... 
troff preprocessor for drawing pictures. 
troff preprocessor for drawing pictures 
true, false — provide truth values 
tset — set terminal modes 
tso — psychiatric consultation 
tsort — topological sort 
tty — file descriptor files ........ 
tty — get terminal name 
ttyld — terminal processing.... 
ttyname, cttyname, isatty, ttyslot — find 
ttys — terminal initialization data 
ttyslot — find name of a terminal 
twid — dabble in oils. 


types — primitive system data types... 
typeset documents and letters 
typeset manual 
typeset mathematics. 
typesetter fonts..... 
typesetting... 
udp operations — 
ul, hp — print underlines on screen 
umask - set file creation mode mask.... 
umount — mount and dismount file system.... 
umount — mount or remove file system 
underlines on screen terminals 


termcap(3) 
thinkblt(9.1) 
alarm(2) 
at(1) 
stime(2) 
time(2) 
time(1) 
time(2) 
profil(2) 
ctime(3) 
times(2) 
utime(2) 
times(2) 
byteyears(1) 
ctime(3) 
tk(1) 
mktemp(3) 
newproc(9.2) 
tolower(3) 
tsort(1) 
touch(1) 
tolower(3) 
weather(7) 
town(7) 
ped(9.1) 
termcap(3) 
tr(1) 
trace(1) 
track(1) 
atc(6) 

tr(1) 
icont(1) 
cbt(3) 
ftw(3) 
trek(6) 
sin(3) 
tbl(1) 
troff(7) 
troff(1) 
proof(9.1) 
apsend(1) 
ideal(1) 
pic(1) 
true(1) 
tset(1) 
doctor(6) 
tsort(1) 
fd(4) 

tty(1) 
ttyld(4) 
ttyname(3) 
ttys(5) 
ttyname(3) 
twid(9.6) 
banner(6) 
file(1) 
stab(5) 
types(5) 
types(9.5) 
types(5) 
monk(1) 
man(7) 
eqn(1) 
font(7) 
troff(1) 
udp(3) 
ul(1) 
umask(2) 
mount(8) 
mount(2) 
ul(1) 
ungetc(3) 


permissions file 
uucp system 


file copy 


mktemp, tmpnam — make a 
connld — 


cu — call 

learn — computer aided instruction about 
uux — unix to 

config — configure a 

uucp, uulog, uuname — unix to 

uux — 

uucp, uulog, uuname — 


rmdir — 

rm, rmdir — remove ( 
pack, pcat, 

mkpkg, inspkg, seal, 


syne — 
update — periodically 

/\point, Irectf, lsegment, Itexture, 
tolower, toupper — force 

town /- gazetteer of 

du — summarize disk 


news — 
setuid, setgid — set 

environ — 

geteuid, getegid, getpid, getppid — get 
su — substitute 

getuid, id — get 

mouse — jerq mouse 

pads — 

telnet — 

menuhit — present 

wall — write to all 

write — write to other 

post — send mail to 

finddev — find processes 

cbt — btree 

news — USENET network news article, 


uucheck — check 

uusched — 

uucleanup — 

uustat — 

uucico — file transport program for the 


CON :.csevceadsiia sonirteestieren saomaneveteemesnroecievan senttecouseatens es 
to"be- avoided sevice censiniscnee ateensiceiene setpgrp, vfork, 
assert — program 

lint — a C program 

Calls to be aVOIdEM 2.0... ee eeeeeeeeeeeneeteeseeeeseeeeeeeeeeseeees setpgrp, 
ex, 

1, 9 Mea eR TR eee 
vmstat — report 

sysmon, 

AVOIdEM se ecceiiasteceredenseacsanaseedes setpgrp, vfork, vadvise, 
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uniq — report repeated lines in a file.. 
unique file name 
unique stream connection 
units — conversion program 


unix remote file copy 
unix to unix command execution 
unix to unix remote file copy 
unlink — remove directory entry 
unlink directory 
unlink) files.............. 
unpack — compress and expand files. 
unseal — automatic software distribution. 
upas — address driven mailer................. 
update — periodically update the super.. 
update super-block................ 
update the super block 
update the super block 
upfront — layer control and graphics . 
upper or lower case.. 
US places.......... 
usage Bae ae 
USENET network news article, utility files... 
user and group ID.... 
user environment 
user, group, or process identity 
user id temporarily 
user identity. 
user interface 
user interface package 
user interface to the telnet protocol... 
user with menu and get selection... 
users .. 
use? ........ 
users by name. 
using a device. 
utilities ........ 
utility files.. 
utime — set file times...... 
utmp, wtmp — login records... 
uucheck — check uucp directories and. 
uucico — file transport program for the .... 
uucleanup — uucp spool directory clean-up.... 
uucp directories and permissions file 
uucp file transport scheduler 
uucp spool directory clean-up 
uucp status inquiry and job control 
uucp system. 
uucp, uulog, uuname — unix to unix remote... 
uusched — uucp file transport scheduler 
uustat — uucp status inquiry and job 
uux — unix to unix command execution... 
uuxqt — execute remote command requests ... 
vadvise, vlimit, vswapon — system calls........ 
varargs — variable argument list........ 
vec, move, etc. — graphics interface 
verification... 
verifier 
vfork, vadvise, vlimit, vswapon — system 
Vitex CILON 2 sa pvey ces stedeiuececcsteastcieegins 
view2d — movie of a function f(x, y, t). 
view2d — movie of a function f(x, y, t).... 
view2d, moviefil — movie of a function 
virtual memory statistics 
vis — show invisible characters. 
visi — mathematical spreadsheet 
vismon — display system statistics 
vlimit, vswapon — system calls to be ie 
vmstat — report virtual memory Statistics 0.0.0... ceceeeeseeseeeeeeeeeeees 


uniq(1) 
mktemp(3) 
connld(4) 
units(7) 
cu(1) 
learn(1) 
uux(1) 
config(8) 
uucp(1) 
uux(1) 
uucp(1) 
unlink(2) 
rmdir(8) 
rm(1) 
pack(1) 
asd(8) 
upas(8) 
update(8) 
sync(2) 
sync(8) 
update(8) 
newlayer(9.2) 
tolower(3) 
town(7) 
du(1) 
news(5) 
setuid(2) 
environ(5) 
getuid(2) 
su(8) 
getuid(1) 
mouse(9.4) 
pads(9.5) 
telnet(1) 
menuhit(9.3) 
wall(8) 
write(1) 
post(1) 
finddev(8) 
cbt(1) 
news(5) 
utime(2) 
utmp(5) 
uucheck(8) 
uucico(8) 
uucleanup(8) 
uucheck(8) 
uusched(8) 
uucleanup(8) 
uustat(1) 
uucico(8) 
uucp(1) 
uusched(8) 
uustat(1) 
uux(1) 
uuxqt(8) 
deprecated(2) 
varargs(3) 
plot(3) 
assert(3) 
lint(1) 
deprecated(2) 
vi(1) 
view2d(1) 
view2d(5) 
view2d(3) 
vmstat(8) 
vis(1) 
visi(1) 
sysmon(9.1) 
deprecated(2) 
vmstat(8) 


flblk, ino — format of file system 

setpgrp, vfork, vadvise, vlimit, 

programming language ...........cseeeseeeeseeseeceeeeeeeeeeeeeaees sh, cd, 
realtime, sendchar,/ request, own, 
wait — 

ftw — file tree 


trek, ogre, sol, warp, sail — 


GILECLOTY series peein cine donna ni teernineie aia pwd, 
who, whois — 


who, 

jps, reshape — create and initialize 
apnews, ap.keys — present AP 

we — 

getchar, fgetc, getw — get character or 
boggle, hangman, scrabble — 

putchar, fputc, putw — put character or 
Pt, Rect, Rpt, display, Drect, Jrect -/ 0... eeeeeeeeseeseeeeeeeneeeees 
dict — look up 

wwb, style, diction, punct — writers 
pwd, where — print machine name and 
chdir, chroot — change 

snake, 


write — 

lseek, tell — move read/ 

wall — 

write — 

wwb, style, diction, punct — 

open — open for reading or 

utmp, 

adventure, zork, aardvark, rogue, 

workbench 
accurate clock 


SPOOlEL Sc. woten geirensieccs eee eoe sted can, bean, dcan, tcan, 
xsend, 

Ut) © PO LATS 55s sssscseecdscaesacccsczscassaysassastansascesdssaagea tecseseetasts 
jO, j1, jn, 


compiler-COmpiler...........cccesceccesesceseeeeseeseeeeeeeseeseeeeaceeseeeeeeneees 
JO, jl, jn, yO, yl, 
dungeon-exploration games..........ceceseeeseeteeeteeeees adventure, 
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volume 
vswapon — system calls to be avoided 
wait — shell, the standard command 
wait — wait for process to terminate.. 
wait, alarm, sleep, nap, kbdchar, revchar, 
wait for process to terminate.... 


wall — write to all users......... 
war games 
we — word count... 
weather — conditions and forecast by town.... 
where — print machine name and working 
who is on the system 
whoami — computer name. 
whois — who is on the system 
windows 
wire storie 
WOLG COUN esscccssaciesecescersounescecasesseentecaceyviasst ecaduaseenseccousosueusecineys 
word from stream . 
word games..........0 
word on a stream 
Word, Point, Rectangle, Bitmap, Texture... eeeeeeeeeseeeeee 
words in English dictionaries 
workbench. 
working directory 
working or root directory 
worm — display chase games... 
worms, hanoi, rain — silly demos...... 
write — write on a file 
write — write to other users... 
write on a file 
write pointer 
write to all users 
write to other users... 
writers workbench 
writing 
wtmp — login records = 
wump — dungeon-exploration games............. 
wwb, style, diction, punct — writers.. 
wwv ~ print and set the date from..... 
xcan — interface to Canon laser-printer . 
xget, enroll — secret mail... 
xstr — preprocessor for sharing strings........... 
yO, yl, yn — bessel functions............. 
yacc, eyacc — yet another... 
yn — bessel functions............. 
zork, aardvark, rogue, WUMP —........:ceesseseeseseeseeseeeeaeeaeeeceeeaeeneeee 


filsys(5) 
deprecated(2) 
sh(1) 
wait(2) 
request(9.2) 
wait(2) 
ftw(3) 
wall(8) 
trek(6) 
we(1) 
weather(7) 
pwd(1) 
who(1) 
whoami(5) 
who(1) 
windows(9.1) 
apnews(7) 
we(1) 
getc(3) 
boggle(6) 
putc(3) 
types(9.5) 
dict(7) 
wwb(1) 
pwd(1) 
chdir(2) 
snake(6) 
worms(6) 
write(2) 
write(1) 
write(2) 
lseek(2) 
wall(8) 
write(1) 
wwb(1) 
open(2) 
utmp(5) 
adventure(6) 
wwb(1) 
wwv(1) 
can(1) 
xsend(1) 
xstr(8) 
j0(3) 
yacc(1) 
j0(3) 


adventure(6) 
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NAME 
intro — introduction to commands 


DESCRIPTION 
This section describes publicly accessible commands in alphabetic order. 


The name of a particular machine at the foot of the page means that the command is there and not necessar- 
ily elsewhere. ‘Local’ means the same, without being specific about where. 


SEE ALSO 
Section (6) for computer games. 
Section (7) for databases. 
Section (8) for ‘hidden’ commands for booting, maintenance, etc. 
How to get started, in the Introduction. 


DIAGNOSTICS 
Upon termination each command returns two bytes of status, one supplied by the system giving the cause 
for termination, and (in the case of ‘normal’ termination) one supplied by the program, see wait and exit(2). 
The former byte is 0 for normal termination, the latter is customarily 0 for successful execution, nonzero to 
indicate troubles such as erroneous parameters, bad or inaccessible data, or other inability to cope with the 
task at hand. It is called variously ‘exit code’, “exit status’ or ‘return code’, and is described only where 
special conventions are involved. 
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NAME 


Eighth Edition =(1) 


=, == -— redo previous shell command 


SYNOPSIS 


= [ pattern ] [ substitutions ] 
== [ pattern ] [ substitutions ] 


DESCRIPTION 
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The = command provides a simple history mechanism for the shell, sh(1). If the environment variable HIS- 
TORY is set, it names a file to which the shell appends the text of each command before execution. = reads 
the HISTORY file for the first previous command matching the pattern, performs the substitutions, and 
executes it. If no pattern is specified, the most recent command is selected. If no substitution is specified, 
the command is executed without modification. 


The pattern matching works for literal text, and is anchored to the beginning of the command line. Adja- 
cent arguments in the pattern are treated as one argument formed of the original argument strings separated 
by spaces. 


Substitutions are of the form 

old=new 
specifying that the string ‘old’ in the command is to be replaced by ‘new.’ Substitutions are performed in 
the order given, and operate on the single leftmost match in the command line. 


The == command is identical to the = command, but before running the command (and after substitutions) 
allows it to be edited. The command is typed out, and a modification request is read from the terminal. 
Generally each character in the request specifies how to modify the character immediately above it, in the 
original command, as described in the following table. 


# Delete the above character. 

% Replace the above character with a space. 

‘ Insert the rest of the request line before the above character. 

$ Delete the characters in the command from this position on; replace them with the rest of the request 
line. 

space or tab 
Leave above character(s) unchanged. 

= as the first and only edit character. Back up to the prior occurrence of the pattern in the history file; 
this may be iterated, and the displayed lines will be unique. 

any other 
This character replaces the one above it. 


If the request line is longer than the command, the overhang is added to the end of the command without 
interpretation, that is, without treating ‘#’, ‘%’, ‘” or ‘$’ specially. Any characters after a ‘~’ or ‘$’ request 
are not interpreted either. 


While correlating character positions, the editor will not process control characters other than tab and new- 
line. 


The tab character prints as a sequence of spaces, and may be modified as if it were that sequence. As long 
as the last space is unmodified, it and the remaining contiguous spaces will represent a tab. 


The history mechanism performs best if each login terminal uses a different HISTORY file. The following 
commands accomplish this. 


HISTOR Y=$HOME/hist/basename \ ‘tty \~ 
>$HISTORY 
export HISTORY 
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NAME 


Eighth Edition ADB(1) 


adb — debugger 


SYNOPSIS 


adb [-w] [ objfil [ corfil ] ] 


DESCRIPTION 


Adb is a general purpose debugging program. It may be used to examine files and to provide a controlled 
environment for the execution of UNIX programs. 


Objfil is normally an executable program file, preferably containing a symbol table; if not then the symbolic 
features of adb cannot be used although the file can still be examined. The default for objfil is ‘a.out’. 
Corfil is assumed to be a core image file produced after executing objfil; the default for corfil is ‘core’. 


Requests to adb are read from the standard input and responses are to the standard output. If the —w flag is 
present then both objfil and corfil are created if necessary and opened for reading and writing so that files 
can be modified using adb. Adb ignores QUIT; INTERRUPT causes return to the next adb command. 


In general requests to adb have the form 
[ address | [, count |] [command] [;] 


If address is present then dot is set to address. Initially dot is set to 0. For most commands count specifies 
how many times the command will be executed. The default count is 1. Address and count are expres- 
sions. 


EXPRESSIONS 
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The value of dot. 


+ The value of dot incremented by the current increment. 


A 


The value of dot decremented by the current increment. 
" The last address typed. 


integer A number. The prefixes 0o and 0O (zero oh) force interpretation in octal radix; the prefixes Ot and 
OT force interpretation in decimal radix; the prefixes Ox and OX or a leading sharp-sign ‘# force 
interpretation in hexadecimal radix. Thus 0020 = 0t16 = 0x10 = sixteen. If no prefix appears, then 
the default radix is used; see the $d command. The default radix is initially hexadecimal. The 
hexadecimal digits are 0123456789abcdefABCDEF with the obvious values. Note that a hexadec- 
imal number whose most significant digit would otherwise be an alphabetic character must have a 
Ox (or OX) prefix (or a leading zero if the default radix is hexadecimal). 


integer .fraction 
A 32 bit floating point number. 


‘cccc ~ The ASCII value of up to 4 characters. \ may be used to escape a *. 


<name_ The value of name, which is either a variable name or a register name. Adb maintains a number of 
variables (see VARIABLES) named by single letters or digits. If name is a register name then the 
value of the register is obtained from the system header in corfil. The register names are those 
printed by the $r command. 


symbol A symbol is a sequence of upper or lower case letters, underscores or digits, not starting with a 
digit. The value of the symbol is taken from the symbol table in objfil. An initial _ or ~ will be 
prepended to symbol if needed. 


_ symbol 
In C, the ‘true name’ of an external symbol begins with . It may be necessary to utter this name 
to disinguish it from internal or hidden variables of a program. 


routine name 
The address of the variable name in the specified C routine. Both routine and name are symbols. 
If name is omitted the value is the address of the most recently activated C stack frame 
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corresponding to routine; if routine is omitted, the active procedure is assumed. 
(exp) The value of the expression exp. 
Monadic operators 
exp The contents of the location addressed by exp in corfil. 
@exp The contents of the location addressed by exp in objfil. 
-exp Integer negation. 
~exp Bitwise complement.’ 
%exp If exp is used as an address, it is in register space; see ADDRESSES . 
Dyadic operators are left associative and are less binding than monadic operators. 
el+e2 Integer addition. 
el-e2 Integer subtraction. 
el,e2 Integer multiplication. 
el%e2 Integer division. 
el&e2 Bitwise conjunction. 
elle2  Bitwise disjunction. 
el#e2 EJ rounded up to the next multiple of e2. 


COMMANDS 
Most commands consist of a verb followed by a modifier or list of modifiers. The following verbs are 
available. (The commands *?’ and ‘/’ may be followed by ‘x’; see ADDRESSES for further details.) 


of Locations starting at address in objfil are printed according to the format f. dot is incremented by 
the sum of the increments for each format letter (q.v.). 

/f Locations starting at address in corfil are printed according to the format f and dot is incremented 
as for ‘*?’. 

=f The value of address itself is printed in the styles indicated by the format f. (For i format ‘?’ is 


printed for the parts of the instruction that reference subsequent words.) 


A format consists of one or more characters that specify a style of printing. Each format character may be 
preceded by a decimal integer that is a repeat count for the format character. While stepping through a for- 
mat dot is incremented by the amount given for each format letter. If no format is given then the last for- 
mat is used. The format letters available are as follows. 


Print 2 bytes in octal. 

Print 4 bytes in octal. 

Print in signed octal. 

Print long signed octal. 

Print in decimal. 

Print long decimal. 

Print 2 bytes in hexadecimal. 

Print 4 bytes in hexadecimal. 

Print unsigned decimal. 

Print long unsigned decimal. 

Print the 32 bit value as a floating point number. 

Print double floating point. 

Print the addressed byte in octal. 

Print the addressed character. 

Print the addressed character using the standard escape convention where control charac- 
ters are printed as “X and the delete character is printed as *?. 
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Print the addressed characters until a zero character is reached. 

Print a string using the *X escape convention (see C above). n is the length of the string 
including its zero terminator. 

Print 4 bytes in date format (see ctime(3)). 

Print as VAX instructions. n is the number of bytes occupied by the instruction. This 
style of printing causes variables 0, (1, ...) to be set to the offset parts of the first (second, 
...) operand of the instruction. 

Print the value of dot in symbolic form. 

Print the addressed value in symbolic form using the same rules for symbol lookup as a. 
When preceded by an integer tabs to the next appropriate tab stop. For example, 8t 
moves to the next 8-space tab stop. 

Print a space. 

Print a newline. 

Print the enclosed string. 

Dot is decremented by the current increment. Nothing is printed. 

Dot is incremented by 1. Nothing is printed. 

Dot is decremented by 1. Nothing is printed. 


newline Repeat the previous command with a count of 1. 


[2/]l value mask 


Words starting at dot are masked with mask and compared with value until a match is found. If L 
is used then the match is for 4 bytes at a time instead of 2. If no match is found then dot is 
unchanged; otherwise dot is set to the matched location. If mask is omitted then —1 is used. 


[?/]w value ... 


Write the 2-byte value into the addressed location. If the command is W, write 4 bytes. 


[2/]m b e f{2/] 


New values for (J, e, f) in the first map entry are recorded. If less than three expressions are given 
then the remaining map parameters are left unchanged. The address type (instruction or data) is 
unchanged in any case. If the ‘?’ or ‘/ is followed by ‘;.’ then the second segment of the mapping 
is changed. If the list is terminated by ‘?’ or ‘/’ then the file (objfil or corfil respectively) is used 
for subsequent requests. (So that, for example, ‘/m?’ will cause ‘/’ to refer to objfil.) 


>name_ Dot is assigned to the variable or register named. 


! A shell is called to read the rest of the line following ‘!’. 
$modifier 
Miscellaneous commands. The available modifiers are: 
<f Read commands from the file f. If this command is executed in a file, further commands 
in the file are not seen. If fis omitted, the current input stream is terminated. If a count is 
given, and is zero, the command will be ignored. The value of the count will be placed in 
variable 9 before the first command in fis executed. 
<<f Similar to < except it can be used in a file of commands without causing the file to be 
closed. Variable 9 is saved during the execution of this command, and restored when it 
completes. There is a (small) finite limit to the number of << files that can be open at 
once. 
>f Append output to the file f, which is created if it does not exist. If fis omitted, output is 
returned to the terminal. 
? Print process id, the signal which caused stopping or termination, as well as the registers. 
This is the default if modifier is omitted. 
r Print the general registers and the instruction addressed by pe. Dot is set to pe. 
R Like $r, but include boring registers like the kernel stack pointer. 
b Print all breakpoints and their associated counts and commands. 
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:modifier 
Manage a subprocess. Available modifiers are: 


VARIABLES 


be 


= oO 


cs 


Ss 


Eighth Edition ADB(1) 


C stack backtrace. If address is given then it is taken as the address of the current frame 
(instead of fp). If C is used then the names and (32 bit) values of all parameters, auto- 
matic and static variables are printed for each active function. If count is given then only 
the first count frames are printed. 

Set the default radix to address and report the new value. Address is interpreted in the 
(old) current radix; ‘10$d’ never changes the default radix. To make decimal the default 
radix, use ‘0t10$d’. A radix of zero is a special case: input with a leading zero is octal, 
that with a leading sharp-sign ‘#’ is hexadecimal, other numbers are decimal; output is 
hexadecimal by default; hex and octal numbers are printed with a leading # and 0 respec- 
tively. 

The names and values of external variables are printed. 

Set the page width for output to address (default 80). 

Set the limit for symbol matches to address (default 255). 

Exit from adb. 

Print all non zero variables in the current radix. 

Print the address maps. 

Simulated VAX memory management: set the system base register pointer to address. 
System space addresses will hereafter be mapped according to the system page table. If 
address is zero, mapping is turned off. 

Set the PCB base pointer to address, which may be either the physical address of a pro- 
cess control block (as found in the PCBB register) or the system space address of a page 
table entry which points to a PCB (as found in p_addr). User space addresses will here- 
after be translated according to the user page tables pointed to by the PCB. Kernel map- 
ping ($k) must already be in effect. If address is zero, user mapping is turned off; 
addresses less than 0x80000000 will be treated as physical addresses. 

$k and $p are useful for system debugging. 


Set breakpoint at address. The breakpoint is executed count—1 times before causing a 
stop. Each time the breakpoint is encountered the command c is executed. If this com- 
mand is omitted or sets dot to zero then the breakpoint causes a stop. 

Delete breakpoint at address. 

Run objfil as a subprocess. If address is given explicitly then the program is entered at 
this point; otherwise the program is entered at its standard entry point. count specifies 
how many breakpoints are to be ignored before stopping. Arguments to the subprocess 
may be supplied on the same line as the command. An argument starting with < or > 
causes the standard input or output to be established for the command. All signals are 
turned on on entry to the subprocess. 

The subprocess is continued. If s is omitted or nonzero, the subprocess is sent the signal 
that caused it to stop; if 0 is specified, no signal is sent. Breakpoints and single-stepping 
don’t count as signals. Breakpoint skipping is the same as for r. 

As for ¢ except that the subprocess is single stepped count times. If a signal is sent, it is 
received before the first instruction is executed. If there is no current subprocess then 
objfil is run as a subprocess as for r. In this case no signal can be sent; the remainder of 
the line is treated as arguments to the subprocess. 

The current subprocess, if any, is terminated. 


Adb provides a number of variables. Named variables are set initially by adb but are not used subse- 
quently. Numbered variables are reserved for communication as follows. 


0,1, ... 


The offset parts of the first, second, ... operands of the last instruction printed. Meaningless if the 
operand was a register. 
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9 The count on the last $< or $<< command. 


On entry the following are set from the system header in the corfil. If corfil does not appear to be a core 
file then these values are set from objfil. 


b The base address of the data segment. 
d The data segment size. 
e The entry point. 
m The ‘magic’ number (0407, 0410 or 0413). 
S The stack segment size. 
t The text segment size. 
ADDRESSES 


FILES 


The address in a file associated with a written address is determined by a mapping associated with that file. 
Each mapping is represented by one or more quadruples (¢ b, e, f), each mapping addresses of type t¢ 
(instruction, data, user block) in the range b through e to the part of the file beginning at address f. An 
address a of type ft is mapped to a file address by finding a quadruple of type t, for which b<a<e; the file 
address is address+f—b. As a special case, if an instruction space address is not found, a second search is 
made for the same address in data space. 


Typically, the text segment of a program is mapped as instruction space, the data and bss segments as data 
space. If objfil is an a.out, or if corfil is a core image or process file, maps are set accordingly. Otherwise, a 
single ‘data space’ map is set up, with b and f set to zero, and e set to a huge number; thus the entire file can 
be examined without address translation. 


The ? and / commands attempt to examine instruction and data space respectively. ?* tries for data space 
(in objfil); /* accesses instruction space (in corfil). 


Registers in process and core images are a special case; they live in a special ‘register’ address space. The 
contents of register 0 are located at address %90; register 1 at %4 (registers are 4 bytes long); and so on. % 
addresses are mapped to the registers for the ‘current frame,’ set by local variable references, and reset to 
the outermost frame (the ‘real’ registers) whenever a process runs or a stack trace is requested. 


Simulated memory management translations (the $k and $p commands) are done before the mapping 
described above. 


So that adb may be used on large files all appropriate values are kept as signed 32 bit integers. 


a.out 
core 
/usr/lib/adb/* parameter files 


SEE ALSO 


pi(9.1), sdb(1), proc(4), a.out(5), core(5) 


DIAGNOSTICS 


BUGS 
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‘Adb’ when there is no current command or format. Comments about inaccessible files, syntax errors, 
abnormal termination of commands, etc. Exit status is 0, unless last command failed or returned nonzero 
status. 


Either the explanation or the implementation of register variables is too complex and arcane. 


0$d should probably be the default. 


ALTRAN(1) Eighth Edition (alice) ALTRAN(1) 


NAME 

altran — language for algebraic manipulation 
SYNOPSIS 

altran [ option ] ... file ... 
DESCRIPTION 


FILES 


Altran compiles the language described in the reference via Fortran as an intermediate language. The files 
may have names ending in .al, for Altran source, .f, for Fortan source, or .o for binary object files. The out- 
put normally includes a .f file for each .al file, a .o file for each old or new -f file, an executable file a.out, 
and a listing file whose name ends in .list for each .al file. 


All the options of f77(1) and [d(1) are accepted with the same meanings. 


The executable a.out file accepts two parameters. One is of the form p=n where n is the number of decimal 
digits of precision to be used for long integers, 18<n<900, default 18. The other parameter is of the form 
w=n where n is the workspace size in thousands of words, 10<n<800, default 50. 


/usr/lib/altran the compiler proper 
/usr/lib/libal.a library 

fort.[789] intermediate files 
*al 

* f 

*.0 

* list 


SEE ALSO 


BUGS 
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f77(1), 1d(1) 
W.S Brown, ALTRAN User’s Manual, Bell Laboratories, Murray Hill, NJ, 1977 


Run-time output is voluminous. 
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NAME 

apply — apply a command to a set of arguments 
SYNOPSIS 

apply [ -ac ] [-n ] command args ... 
DESCRIPTION 


Apply runs the named command on each argument arg in turn. Normally arguments are chosen singly; the 
optional number n specifies the number of arguments to be passed to command. If n is zero, command is 
run without arguments once for each arg. Character sequences of the form %d in command, where d is a 
digit from | to 9, are replaced by the d’th following unused arg. If any such sequences occur, n is ignored, 
and the number of arguments passed to command is the maximum value of d in command. The character 
“%’ may be changed by the —a option. 
EXAMPLES 
apply echo * 
is a time-consuming way to do ‘ls —-1’ 
apply —2 cmp al bl a2 b2... 
compares the ‘a’ files to the ‘b’ files 
apply —0 date ~seq 20° 
runs date 20 times; like ‘for iin “seq 20°; do date; done’ 
SEE ALSO 
sh(1) 


BUGS 


Shell metacharacters in command may have bizarre effects; it is best to enclose complicated commands in 
single quotes * *. 
There is no way to pass a literal ‘%2’ if *%’ is the argument expansion character. 
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NAME 


apsend — send troff output to aps-5 


SYNOPSIS 


apsend [ options ] [ file ] ... 


DESCRIPTION 


Apsend sends troff(1) output in the named file or in the standard input for typesetting on the Murray Hill 
Computer Center APS-5 machine. 


The options, which need only be spelled far enough to be unique, are 


account=xx 
GCOS account number (default from password file). 


bin=xx Computer center bin number (default from password file). 


mailto=xx 
Mailing instructions, up to 28 characters, instead of comp center bin. 


comment=xx 

Up to 30 characters, for APSLOG file entry. Default value is the filename or pipe.end. 
device=imagen 

Print on comp center laser printer instead of phototypesetter. 


FILES 

/usr/lib/apsend/* 

APSLOG record of apsend activity 
SEE ALSO 
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troff(1), d202(1) 


AR(1) 
NAME 
SYNOPSIS 
DESCRIPTION 

d 

r 

q 

t 

p 

x 

Vv 

c 

] 
FILES 
SEE ALSO 
BUGS 
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ar, ranlib — archive and library maintainer 


ar key [ posname ] afile name ... 


ranlib archive ... 


Ar maintains groups of files combined into a single archive file. Its main use is to create and update library 
files for the loader /d(1). It can be used, though, for any similar purpose. 


Key is one character from the set drqtpmx, optionally concatenated with one or more of vuaibcl. Afile is 
the archive file. The names are constituent files in the archive file. The meanings of the key characters are: 


Delete the named files from the archive file. 


Replace the named files in the archive file. If the optional character u is used with r, then only 
those files with modified dates later than the archive files are replaced. If an optional positioning 
character from the set abi is used, then the posname argument must be present and specifies that 
new files are to be placed after (a) or before (b or i) posname. Otherwise new files are placed at 
the end. 


Quickly append the named files to the end of the archive file. Optional positioning characters are 
invalid. The command does not check whether the added members are already in the archive. 
Useful only to avoid quadratic behavior when creating a large archive piece-by-piece. 


Print a table of contents of the archive file. If no names are given, all files in the archive are 
tabled. If names are given, only those files are tabled. 


Print the named files in the archive. 


Move the named files to the end of the archive. If a positioning character is present, then the 
posname argument must be present and, as in r, specifies where the files are to be moved. 


Extract the named files. If no names are given, all files in the archive are extracted. In neither case 
does x alter the archive file. 


Verbose. Under the verbose option, ar gives a file-by-file description of the making of a new 
archive file from the old archive and the constituent files. When used with t, it gives a long listing 
of all information about the files. When used with p, it precedes each file with a name. 


Create. Normally ar will create afile when it needs to. The create option suppresses the normal 
message that is produced when afile is created. 


Local. Normally ar places its temporary files in the directory /tmp. This option causes them to be 
placed in the local directory. 


Ranlib adds a table of contents “__SYMDEF’ to each library archive. This makes it possible for the loader 
Id(1) to extract all necessary files from an archive in one pass regardless of the order of the archive. 


/tmp/v* temporaries 


1d(1), ar(5) 


If the same file is mentioned twice in an argument list, it may be put in the archive twice. 

Failure to do both ar and ranlib steps may cause phase errors in libraries. Consequently the loader /d warns 
when a library is newer than its table of contents; but this means you get the warning even if you only copy 
the library. 
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NAME 
as — assembler 


SYNOPSIS 
as [option ] ... [ name ]... 
DESCRIPTION 
As assembles the named files, or the standard input if no file name is specified. The options are: 


-dn Specifies the number of bytes n (1, 2, or 4) to be assembled for offsets which involve forward or 
external references, and which have sizes unspecified in the assembly language. Default is -d4. 


-L Save defined labels beginning with a “L’, which are normally discarded to save space in the resul- 
tant symbol table. The compilers generate such temporary labels. 


-V Use virtual memory for intermediate storage, rather than a temporary file. 
-W Do not complain about errors. 
-J Use long branches to resolve jumps when byte-displacement branches are insufficient. This must 


be used when a compiler-generated assembly contains branches of more than 32k bytes. 


-R Make initialized data segments read-only, by concatenating them to the text segments. This obvi- 
ates the need to run editor scripts on assembly code to make initialized data read-only and shared. 


-t Specifies a directory to receive the temporary file, other than the default /tmp. 
-oobj Place output in file obj. Default is ‘a.out’. 


All undefined symbols in the assembly are treated as global. 


FILES 
/tmp/as* default temporary file 
a.out default object file 
SEE ALSO 


Id(1), nm(1), adb(1), pi(9.1), a.out(S) 
Auxiliary documentation Assembler Reference Manual. 


BUGS 
-J should be eliminated; the assembler should automatically choose among byte, word and long branches. 
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NAME 
asa — interpret ASA control characters 


SYNOPSIS 
asa [ file ] ... 

DESCRIPTION 
Asa takes files which were written with ASA carriage control characters, usually by FORTRAN programs, 
converts them to a form suitable for printing on a terminal, line printer, and so on, and writes the results on 
the standard output. 


The control characters handled are: 


single space 

0’ double space 

- triple space 

overprint the previous line 
on start a new page 


If no file names are given, the standard input is used. 


Each input file given starts a new page. A skip to a new page on the first line of the first input file is 
ignored. 
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NAME 

ascii — interpret ASCII characters 
SYNOPSIS 

ascii [-oxd | -bn ] [ -net ] [-e ] [ text ] 
DESCRIPTION 


Ascii prints the ASCII values corresponding to characters and vice versa. The values are interpreted in a 
settable numeric base; -o0 specifies octal (the default), -d decimal, —-x hexadecimal, and -bn base n . 


With no arguments, ascii reproduces /usr/pub/ascii in the specified base. Any given characters of text are 
converted to their ASCII values, one per line. If, however, the first argument of text is a valid number in 
the specified base, it is printed as plain text (control characters are printed as they appear in /usr/pub/ascii). 
The option -n forces the output to numeric form and -c forces the output to printable characters. The 
option -t converts, without interpretation, from numbers to text. Finally, -e forces the following arguments 
to be interpreted as text . 


EXAMPLES 
ascii —d Print the ASCII table base 10. 


ascii p Print the octal value of ‘p’. 


ascii 160 
Show which character is octal 160. 


SEE ALSO 
ascii(7) 
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at — execute commands at a later time 


SYNOPSIS 


at time [ day ] [ file ] 


DESCRIPTION 


FILES 


At squirrels away a copy of the named file (standard input default) to be used as input to sh(1) at a specified 
later time. A cd command to the current directory is inserted at the beginning, followed by assignments to 
all environment variables. When the script is run, it uses the user and group ID of the creator of the copy 
file. 


The time is 1 to 4 digits, with an optional following ‘A’, ‘P’, ‘N’ or ‘M’ for AM, PM, noon or midnight. 
One and two digit numbers are taken to be hours, three and four digits to be hours and minutes. If no letters 
follow the digits, a 24 hour clock time is understood. 


The optional day is either (1) a month name followed by a day number, or (2) a day of the week; if the word 
‘week’ follows invocation is moved seven days further off. Names of months and days may be recogniz- 
ably truncated. Examples of legitimate commands are 


at 8am jan 24 
at 1530 fr week 


At programs are executed by periodic execution of the command /usr/ib/atrun from cron(8). The granular- 
ity of at depends upon how often atrun is executed. 


Standard output or error output is lost unless redirected. 


/usr/lib/atrun executor (run by cron(8)). 


in /usr/spool/at: 


yy.ddd.hhhh.* activity for year yy, day dd, hour hhhh. 
lasttimedone last hhhh 
past activities in progress 


SEE ALSO 


BUGS 
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calendar(1), pwd(1), sleep(1), cron(8)d times out of range. 


Due to the granularity of the execution of /usr/lib/atrun, there may be bugs in scheduling things almost 
exactly 24 hours into the future. 


AWK (1) Eighth Edition AWK(1) 
NAME 

awk — pattern-directed scanning and processing language 
SYNOPSIS 


awk [ -Fs ] [ prog ] [ file]... 


DESCRIPTION 


Page | 


Awk scans each input file for lines that match any of a set of patterns specified literally in prog or in a file 
specified as -f file. With each pattern there can be an associated action that will be performed when a line 
of a file matches the pattern. Each line is matched against the pattern portion of every pattern-action state- 


ment; the associated action is performed for each matched pattern. The file name ‘“—’ means the standard 
input. 


An input line is made up of fields separated by white space. (This default can be changed by using FS, vide 
infra.) The fields are denoted $1, $2, ... ; $0 refers to the entire line. 


A pattern-action statement has the form 

pattern { action } 
A missing { action } means print the line; a missing pattern always matches. 
An action is a sequence of statements. A statement can be one of the following: 


if (conditional ) statement [ else statement | 

while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 
for ( var in array ) statement 


break 

continue 

{ [ statement ] ... } 

expression # commonly variable = expression 


print [ expression-list ] [ >expression ] 

printf format [ , expression-list ] [ >expression ] 

next # skip remaining patterns on this input line 
exit [expr] # skip the rest of the input; exit status is expr 


Statements are terminated by semicolons, newlines or right braces. An empty expression-list stands for the 
whole line. Expressions take on string or numeric values as appropriate, and are built using the operators +, 
-, *, /, %, ~ (exponentiation), and concatenation (indicated by a blank). The C operators ++, —, +=, —=, *=, 
/=, %= and “= are also available in expressions. Variables may be scalars, array elements (denoted x[i]) or 
fields. Variables are initialized to the null string. Array subscripts may be any string, not necessarily 


" 


numeric; this allows for a form of associative memory. String constants are quoted "...". 


The print statement prints its arguments on the standard output (or on a file if >file is present or on a pipe if 
|cmd is present), separated by the current output field separator, and terminated by the output record separa- 
tor. The printf statement formats its expression list according to the format (see printf(3)). The function 
close closes the file or pipe named as its argument. 


The built-in function /ength returns the length of its argument taken as a string, or of the whole line if no 
argument. There are also built-in functions exp, log, sqrt, sin, cos, atan2, rand (returns a random number 
on (0,1)), srand (sets seed for rand), and int (truncates its argument to an integer). substr(s, m, n) returns 
the n-character substring of s that begins at position m. index(s, t) returns the position in s where t occurs, 
or 0 if it does not. The function split(s, a, fs) splits the string s into array elements a//], a[2], ..., a[n], and 
returns n. The separation is done with the regular expression fs or with the field separator FS if fs is not 
given. 


The function sub(r, t, s) substitutes ¢ for the first occurrence of the regular expression r in the string s. If s 
is not given, $0 is used. The function gsub is the same except that all occurrences of the regular expression 
are replaced. Sub and gsub return the number of replacements. 
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The function sprintf(fmt, expr, expr, ...) formats the expressions according to the printf(3) format given by 
fmt and returns the resulting string. 


The function system(cmd) executes cmd and returns its exit status The function getline sets $0 to the next 
input record from the current input file; getline <file sets $0 to the next record from file. getline x sets vari- 
able x instead. Finally, cmd|getline pipes the input of cmd into getline; each call of getline returns the next 
line of output from cmd. In all cases, getline returns 1 for a successful input, 0 for end of file, and —1 for an 
error. 


Patterns are arbitrary Boolean combinations (1, ||, &&, and parentheses) of regular expressions and rela- 
tional expressions. Regular expressions are as in egrep(1). Isolated regular expressions in a pattern apply 
to the entire line. Regular expressions may also occur in relational expressions, using the operators ~ and !". 
/re/ is a constant regular expression; in addition, any string (constant or variable) may be used as a regular 
expression, except in the position of an isolated regular expression in a pattern. 


A pattern may consist of two patterns separated by a comma; in this case, the action is performed for all 
lines between an occurrence of the first pattern and the next occurrence of the second, inclusive. 


A relational expression is one of the following: 


expression matchop regular-expression 
expression relop expression 


where a relop is any of the six relational operators in C, and a matchop is either ~ (for contains) or !~ (for 
does not contain). A conditional is an arithmetic expression, a relational expression, or a Boolean combina- 
tion of these. 


The special patterns BEGIN and END may be used to capture control before the first input line is read and 
after the last. BEGIN and END do not combine with other patterns. 


A regular expression r may be used to separate fields, by assigning to the variable FS or by means of the 
—Fs option. 


Other variable names with special meanings include NF, the number of fields in the current record; NR, the 
ordinal number of the current record; FNR, the ordinal number of the current record in the current file; 
FILENAME, the name of the current input file; RS, the input record separator (default newline); OFS, the 
output field separator (default blank); ORS, the output record separator (default newline); OFMT, the out- 
put format for numbers (default "%.6g"); ARGC, the argument count; and ARGV, the argument array. 
ARGC and the ARGV array may be altered; non-null members are taken as filenames. 


Functions may be defined (at the position of a pattern-action statement) as 

func foo(a, b, c) {...} 
Parameters are passed by value if scalar and by reference if array name; functions may be called recur- 
sively. Parameters are local to the function; all other variables are global. The return statement may be 
used to return a value. 


EXAMPLES 
Print lines longer than 72 characters: 


length > 72 
Print first two fields in opposite order: 
{ print $2, $1 } 


Same, with input fields separated by comma and/or blanks and tabs: 
BEGIN { FS =",[ \t]*|[ \t]+" } 
{ print $2, $1 } 


Add up first column, print sum and average: 


{st+=$1} 
END __{ print "sum is", s, " average is", s/NR } 
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Print all lines between start/stop pairs: 
/start/, /stop/ 
Simulate echo(1): 
BEGIN { 
for (i = 1;1< ARGC; i++) 
printf "%s ", ARGV[i] 
printf "\n" 
exit 


SEE ALSO 
lex(1), sed(1), sno(1) 
A. V. Aho, B. W. Kernighan, P. J. Weinberger, Awk — a pattern scanning and processing language: user’s 
manual 


BUGS 
There are no explicit conversions between numbers and strings. To force an expression to be treated as a 
number add 0 to it; to force it to be treated as a string concatenate "" to it. 


The scope rules for variables in functions are a botch. 
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NAME 
basename, dirname — strip filename affixes 


SYNOPSIS 
basename string [ suffix ] 


dirname string 


DESCRIPTION 
These functions split off useful parts of a pathname; they are typically used inside substitution marks ~~ in 
shell scripts. 


Basename deletes any prefix ending in ‘/ and the suffix, if present in string, from string, and prints the 
result on the standard output. 


Dirname deletes the last ‘/’ and all following characters from the string and prints the result on the standard 
output. If there is no ‘/, dirname prints ‘.’. 


EXAMPLES 
cc $1 —-o ‘basename $1° 
compile ‘dir/file.c’ into ‘file’ 


cc $1 —o “dirname $1*/basename $1* 
compile into ‘dir/file’ 


SEE ALSO 
sh(1) 
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NAME 
basic, bas, bite — Basic language interpreters 


SYNOPSIS 
/usr/bin/Icl/basic 


/usr/bin/Icl/bas 
/usr/bin/Icl/bite 


DESCRIPTION 
Of these three completely different Basic interpreters, basic is the biggest, and unfortunately the best. 
Caveat emptor. 
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NAME 
be — arbitrary-precision arithmetic language 
SYNOPSIS 
be [-c] [-1][ file ... ] 
DESCRIPTION 
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Bc is an interactive processor for a language which resembles C but provides unlimited precision arith- 
metic. It takes input from any files given, then reads the standard input. The -l argument stands for the 
name of an arbitrary precision math library. The following syntax for bc programs is like that of C; L 
means letter a-z, E means expression, S means statement. 


Comments 
are enclosed in /* and */. 


Names 
simple variables: L 
array elements: L [ E ] 
The words ‘ibase’, ‘obase’, and ‘scale’ 


Other operands 
arbitrarily long numbers with optional sign and decimal point. 
(E) 
sqrt (E ) 
length (E ) number of significant decimal digits 
scale (E ) number of digits right of decimal point 
L(E,.:.,E) 

Operators 
+ — * / % ~(% is remainder; * is power) 
++ — (prefix and postfix; apply to names) 
== <= >= I= < > 


ste = *= f= HH "= 


Statements 
E 
{S3..35 } 
if(E)S 
while(E)S 
for(E;E;E)S 
null statement 
break 
quit 

Function definitions 
define L(L,...,L) { 


auto L,..., L 
Ss55 
return (E ) 

} 

Functions in -I math library 

s(x) sine 

c(x) cosine 

e(x) exponential 

(x) log 

a(x) arctangent 


j@,x) Bessel function 


BC(1) 
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All function arguments are passed by value. 


The value of a statement that is an expression is printed unless the main operator is an assignment. Either 
semicolons or newlines may separate statements. Assignment to scale influences the number of digits to be 
retained on arithmetic operations in the manner of dc(1). Assignments to ibase or obase set the input and 
output number radix respectively. 


The same letter may be used as an array, a function, and a simple variable simultaneously. All variables are 
global to the program. ‘Auto’ variables are pushed down during function calls. When using arrays as func- 
tion arguments or defining them as automatic variables empty square brackets must follow the array name. 


Bc is actually a preprocessor for dc(1), which it invokes automatically, unless the -c (compile only) option 
is present. In this case the dc input is sent to the standard output instead. 


EXAMPLE 
scale = 20 
define e(x){ 
auto a, b,c, i, S 
a=1 
b=1 
s=1 
forG=1; 1==1; 1++){ 
a= a*x 
b = b*i 
c=a/b 
if(c == 0) return(s) 
S =S+c 
} 
} 


defines a function to compute an approximate value of the exponential function and 
forG=1; i<=10; i++) e(i) 


prints approximate values of the exponential function of the first ten integers. 


FILES 
/usr/lib/lib.b mathematical library 
dc(1) desk calculator proper 
SEE ALSO 


BUGS 


de(1), hoc(1) 
L. L. Cherry and R. Morris, BC — An arbitrary precision desk-calculator language 


No &&, ||, or ! operators. 
For statement must have all three E’s. 
Quit is interpreted when read, not when executed. 
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NAME 

bundle — collect files for distribution 
SYNOPSIS 

bundle files 
DESCRIPTION 


Bundle writes on its standard output a shell (sh(1)) file that, when executed, will recreate the original files. 
Its main use is for distributing small numbers of text files by mail(1). 


Although less refined than standard archive from ar(1), cpio(1), or tar(1), a bundle file is self-documenting 
and complete; little preparation is required on the receiving machine. 
EXAMPLES 
bundle makefile *.[ch] | mail elsewhere!mark 
Send mark a makefile with related ‘.c’ and ‘.h’ files. Upon receving the mail, mark may save the 
file, in ‘gift/horse’ for example, edit out the postmark, then do 
cd gift; sh horse; make 
SEE ALSO 
ar(1), cpio(1), tar(1), mail(1) 
BUGS 


Bundle will not create directories and is unsatisfactory for non-ASCII files. 
Beware of gift horses. 
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NAME 
byteyears — time-space product for file residency 

SYNOPSIS 
byteyears [-a] [file]... 

DESCRIPTION 
Byteyears reports the product of the age of each file in years and the length in bytes. Files for which this 
number is large may be reasonable candidates for deletion. If the file is a directory, byteyears reports 
(recursively) on everything in that directory. If no arguments are given, the current directory is assumed. If 
the —a option is given, the time since last access is used instead of the time since last modification. 
Each line of output contains the number of byte years (rounded to the nearest integer), the size of the file in 
bytes, the time last modified, and the name of the file. 

EXAMPLE 
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byteyears | sort -r | sed 10q 
List the ten leading candidates in the current directory. 
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NAME 
cal — print calendar 


SYNOPSIS 
cal [ month ] year 


DESCRIPTION 
Cal prints a calendar for the specified year. If a month is also specified, a calendar just for that month is 
printed. Year can be between 1 and 9999. The month is a number between 1 and 12. The calendar pro- 
duced is that for England and her colonies. 


Try September 1752. 


BUGS 
The year is always considered to start in January even though this is historically naive. 
Beware that ‘cal 78’ refers to the early Christian era, not the 20th century. 
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NAME 


calendar — reminder service 


SYNOPSIS 


calendar [-]|[n] 


DESCRIPTION 


FILES 


Calendar consults calendar files and prints out lines that contain today’s date or any date up through the nth 
working day hence (n=1 by default). Most American-style month-day dates such as “Dec. 7,’ ‘december 7,’ 
‘12/7,’ etc., are recognized, but not “7/12’. The symbol **’ denotes every month as in ‘* 7’ or “*/7’. A year 
may follow the day, as in “Dec 7, 84’, “Dec 7 1984’, or “12/7/84’. 


By default, the program consults the file ‘calendar’ in the $HOME directory (see sh(1)), or in the current 
directory if a home directory is not known. Other calendar files to be consulted may be specified by lines of 
the form 


#include ''file" 
in the calendar file. Includes do not nest. 


When the ‘—’ argument is present, calendar reminds all users of their calendar engagements by mail(1). 
Normally this happens daily in the wee hours under control of cron(8). Calendars not in home directories, 
or recipients not registered as users, may be registered for reminder service by placing lines of the form 
‘pathname mailname’ in file /usr/lib/calendar. 


calendar files 

/usr/lib/calendar 

/etc/passwd 

/tmp/cal* 

egrep, echo, join, sort, sed, mail, /usr/lib/calendar? — subprocesses 


SEE ALSO 


BUGS 
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at(1) 


The mail reminder service doesn’t work when it finds less than two calendars. 
Your calendar must be public information for you to get reminder service. 
Holidays are what the program says they are. 
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NAME 
can, bean, dcan, tcan, xcan — interface to Canon laser-printer spooler 


SYNOPSIS 
can [ option ... ] [ file ... ] 


bean [ option ... | [ file... ] 
dean [ option ... ] [ file... ] 
tcan [ option ... | [ file ... ] 
xcan [ option ... | [ file ... ] 


DESCRIPTION 
These commands print files (standard input by default) on Canon laser printers. Four commands, all special 
cases of the generic xcan, handle particular kinds of data files: 


can ASCII text 

bcan _ bitmap images created by blitbit(9.1) 

dcan output from troff(1) 

tcan output for a Tektronix 4014 terminal, as produced by plot(1) 


The destination printer is determined in the following ways, listed in order of decreasing precedence. 
Printer names are given in candest(7). 


option —d dest 
environment variable CANDEST 
printer named in file /etc/candest 


Options: 

-d dest select the destination printer, see candest(7). 

-f font set the font (default CW.11) for can, see font(7). 

-L (landscape) rotate bcan pages 90 degrees. 

-—In set number of lines per page for can (default 66). 

—mn set bcan magnification (default 2). 

—n spool only, input has already been formatted by a remote xcan. 


-o list print only pages whose page numbers appear in the comma-separated list of numbers and ranges. 
A range n—m means pages n through m; a range —n means from the beginning to page n; a range 
n— means from page n to the end. —o implies -r. 


-r print pages in reverse order (default for can and dcan). 

-sb make xcan expect bcan input; -sb implies defaults of -x176 and -y96. 
—sc make xcan expect can input; —se does not imply -r. 

—sd make xcan expect dcan input; -sd does not imply -r. 

-st make xcan expect tcan input. 


-tn tcan scale factor is (n/100)/(n%100). The default is 813, i.e., 13 tekpoints become 8 dots on the 
laser printer. 


—u user set the name which appears on the banner page; default is login name. 


-xn set the horizontal offset of the print image, measured in dots (default 48). There are 240 dots to 
the inch. 
-yn set the vertical offset of the print image (default 0), except in tcan, where this option specifies n 


extra tekpoints vertically. 
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FILES 
/etc/candest default destination 
/usr/can/font font directory 
/usr/spool/jpd_ spool directory 


SEE ALSO 
blitbIt(9.1), plot(1), pr(1), revpag(1), troff(1), candest(7), font(7) 


BUGS 
The ‘landscape’ option is supported only by bcan; -o and -r are supported only by can and dcan. 
There ought to be a way to determine the service class from the input data. 
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NAME 
cat — catenate and print 
SYNOPSIS 
cat file ... 
DESCRIPTION 
Cat reads each file in sequence and writes it on the standard output. Thus 
cat file 
prints the file and 
cat file! file2 >file3 
concatenates the first two files and places the result on the third. 
If no file is given, or if the argument ‘—’ is encountered, cat reads from the standard input. Output is buf- 
fered in blocks matching the input. 
SEE ALSO 
pr(1), ep(1) 
BUGS 


Beware of ‘cat a b >a’ and ‘cat ab >b’, which destroy input files before reading them. 
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NAME 
cb, pp — C program beautifier and pretty printer 


SYNOPSIS 
cb [ option ] ... [ file]... 
pp [ option ] ... [ file ] ... 


DESCRIPTION 
Cb reads C programs either from the named files or from the standard input and writes them on the standard 
output with spacing and indentation that displays the structure of the code. The options are: 


-s place newlines as in Kernighan and Ritchie. (Original newlines are preserved by default.) 
-j join split lines. 
-lleng split lines that are longer than Jeng. 


Pp formats the named C source files, or its standard input if none are given, and writes a ‘publication for- 
mat’ on the standard output for printing on a typesetter with filters like d202(1). The options are 


-Tdev prepare output for devices named as in troff(1); default is 202 
-b use bold fonts suffixed ‘K’ rather than ‘B’ 
-ffont set the main font; the default is MM, Memphis Medium 


-kfile cause words in the named file, one per line, to be recognized as keywords; the file will be looked 
up in /usr/lib/pp if it is not in the current directory 


-ttitle generate a title page with the title specified and a date stamp 


DIAGNOSTICS 
Pp complains and exits if it cannot find a required font. If this happens, take the name of the missing font 
to a local font guru. 


SEE ALSO 
pr(1), troff(1), d202(1), dcan(1), etc. 
B. W. Kernighan and D. M. Ritchie, The C Programming Language, Prentice-Hall, 1978. 


BUGS 
Punctuation hidden in preprocessor statements causes cb to make indentation errors. 
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NAME 
cbt — btree utilities 


SYNOPSIS 
cbt creat name ... 
cbt report name ... 
cbt cat [—R ] name ... 
cbt squash name 
cbt build [ —R ] name 
cbt add [ —R | name 
cbt delete [ —R ] name 


DESCRIPTION 
A B-tree name corresponds to a pair of files named name.T and name.F. Name.T contains an access tree, 
and name.F contains the data. 


The creat version of the command creates empty B-trees. 
The report version of the command scans each B-tree and reports how many records it contains. 


The cat version of the command scans the B-tree in key-sort order, writing on its standard output. With no 
option, cat writes each key followed by a tab, followed by the record, followed by a new-line. If option -R 
(raw) is present, each key-record pair has the format 


struct { 
short keylen; 
char key[keylen]; 
short reclen; 
char rec[reclen]; 
}s 
Keys and records are not null-terminated and consecutive key-record pairs are not separated by new-lines. 
Keys may be no longer than 127 bytes. 


The squash version of the command compresses the access tree to minimal size. 


The build version of the command reads a sorted list of keys and records from the standard input and fills 
the file with them. Input is in the form produced by the corresponding cat option. 


The add (delete) version of the command inserts (removes) records. Input is in the form produced by the 
corresponding cat option. The records may be unsorted. In newline-separated input only the keys must be 
present. 


EXAMPLE 
sort "-t<tab>" —1 inputfile | cbt build btreefile 
<tab> denotes a tab character 


FILES 

/usr/lib/btree/* 
SEE ALSO 

cbt(3) 
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NAME 


Eighth Edition CC(1) 


cc, CC —C compilers 


SYNOPSIS 


ce [ option ] ... file ... 
CC [ option ] ... file ... 


DESCRIPTION 
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Cc compiles the language C; and CC compiles C++. File arguments ending with 


.C are taken to be C source programs; they are compiled, and each object program is left on the file 
whose name is that of the source with ‘.o’ substituted for ‘.c’. The ‘.o’ file is normally deleted, 
however, if a single C program is compiled and loaded all at one go. 


S are taken to be assembly source programs and are assembled, producing a ‘.o’ file. 
The following options are interpreted by cc and CC. See /d(1) for load-time options. 


-c Suppress the loading phase of the compilation, and force an object file to be produced even if only 
one program is compiled. 


-g Have the compiler produce additional symbol table information for sdb(1) or pi(9.1). Also pass 
the —-Ig flag to /d(1). 

-w Suppress warning diagnostics. 

-p Arrange for the compiler to produce code which counts the number of times each routine is called; 


also, if loading takes place, replace the standard startup routine by one which arranges to gather 
profiling data for later examination by prof(1). 


-O Invoke an object-code improver. 

-R Passed on to as, making initialized variables shared and read-only. 

-S Compile the named C programs, and leave the assembler-language output on corresponding files 
suffixed ‘.s’. 

-E Run only the macro preprocessor on the named C programs, and send the result to the standard 
output. 


-F[c] Run only the macro preprocessor and the C++ front end cfront on the named C programs, and send 
the result to the standard ouput. If c is present, produce output suitable for input to cc. 


-C Prevent the macro preprocessor from eliding comments. 
—0 output 
Name the final output file output. If this option is used the file ‘a.out’ will be left undisturbed. 
-Dname=def 
-Dname Define the name to the preprocessor, as if by ‘#define’. If no definition is given, the name is 
defined as "1". 


-Uname Remove any initial definition of name. 


-Idir ‘#include’ files whose names do not begin with ‘/’ are always sought first in the directory of the 
file argument, then in directories named in -I options, then in directories on a standard list. 


These options are peculiar to cc: 


-Bstring 
Find substitute compiler passes in the files named string with the suffixes cpp, ccom and c2. If 
String is empty, use a standard backup version. 


—t[p012] 
Find only the designated compiler passes in the files whose names are constructed by a —B option. 
In the absence of a —B option, the string is taken to be ‘/usr/c/’. 


CC(1) Eighth Edition CC(1) 
These options are peculiar to CC: 
—.suffix Instead of the standard output, place -E and -F output in files whose name is that of the source 
with .suffix substituted for ‘.c’. 
+E Use C rules for scope of non-local names. 
+S Print debugging information from cfront on the standard error file. 
+d Don’t expand inline functions. 
+xname Take size and alignment information from file name for cross compiling. 
cppC=/lib/cpp 
cfrontC=/usr/bin/cfront 
ccC=/bin/cc 
environment parameters and their defaults; see FILES below 
Other arguments are taken to be either loader options or C-compatible object programs, typically produced 
by an earlier cc run, or perhaps libraries of C-compatible routines. These programs, together with the 
results of any compilations specified, are loaded (in the order given) to produce an executable program with 
name a.out. 
FILES 
file.c input file 
file.i cfront output 
file.o object file 
a.out loaded output 
/tmp/ctm? temporary 
/lib/cpp preprocessor 
Nib/ecom C compiler 
/usr/bin/cfront CC front end, filter from C++ to C 
Nib/c2 optional optimizer 
Nib/crt0.o runtime startoff 
/ib/mert0.o startoff for profiling 
/lib/libc.a standard library, see (3) 
Nib/libC.a C++ library 
/usr/include standard directory for C ‘#include’ files 
/media/acher/Games/v8/usr/include/CCstandard directory for C++ “#include files’ 
SEE ALSO 
B. W. Kernighan and D. M. Ritchie, The C Programming Language, Prentice-Hall, 1978 
D.M. Ritchie, C Reference Manual 
B. Stroustrup, A C++ Tutorial, AT&T Bell Labs CSTR-113, 1984 
B. Stroustrup, C++ Reference Manual, AT&T Bell Labs CSTR-108, 1984 
lint(1), cyntax(1), 1d(1), prof(1), adb(1), sdb(1), pi(9.1) 
DIAGNOSTICS 
The diagnostics produced by the compilers are intended to be self-explanatory. Occasional messages may 
be produced by the assembler as(1) or loader /d(1). 
BUGS 


CC can not yet handle certain constructs, for which it reports, "sorry, not implemented." 
To permit the use of standard, untyped C libraries, CC makes the loader name of the first function having a 
given name agree with the loader name from cc. Thus 


overload read(int,char*,int), read(vector*); 


arranges for read(2) to be called, as well as another ‘read’ for a newly defined type. Reversing the declara- 
tions would cause chaos, even in programs that do not directly call read(2), but do use stdio (3) input. 
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NAME 


cflow — generate C flow graph 


SYNOPSIS 


cflow [ option ] ... file ... 


DESCRIPTION 


Cflow analyzes a collection of C, yacc(1), lex(1), assembler and object files and displays (on the standard 
output) a chart of external references. The —-I, -D and -U options of cc(1) are understood. 


Each line of output begins with a reference (i.e., /ine) number, followed by a suitable number of tabs indi- 
cating call level. Then the name of the global (function or variable), a colon and its definition. For infor- 
mation extracted from C source, the definition consists of an abstract type declaration (e.g., char *), the 
name of the source file and the line number where the definition was found. Definitions extracted from 
object files merely indicate the file name and location counter under which the symbol appeared (e.g., text). 
Leading underscores in C-style external names are deleted. 


Once a definition of a name has been printed, subsequent references to that name contain only the reference 
number of the line where the definition may be found. For undefined references, a question mark is printed. 


The graph is printed from the top down. Any argument which is a simple string (has no recognizable 
suffix) is taken to mean the name of a starting node. 


EXAMPLES 
Input file, t.c cflow output 

int 1; 1 main: int(), t.c 4 

main(){ 2 f: intQ), t.c 10 
fQ; 3 h: ? 
gO; 4 i: int, t.c 1 
£0; 5 gi? 

} 

fO { 
i=h0; 

} 


cflow printf /lib/libc.a 
display printf() and everything it refers to 


SEE ALSO 


FILES 
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cc(1), lint(1), nm(1) 
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NAME 


chmod — change mode 


SYNOPSIS 


chmod mode file ... 


DESCRIPTION 


The mode of each named file is changed according to mode, which may be absolute or symbolic. An abso- 
lute mode is an octal number constructed from the OR of the following modes: 


4000 set user ID on execution 

2000 set group ID on execution 

1000 sticky bit, see chmod (2) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 
0070 read, write, execute (search) by group 

0007 read, write, execute (search) by others 


A symbolic mode has the form: 
[who] op permission [op permission] ... 


The who part is a combination of the letters u (for user’s permissions), g (group) and o (other). The letter a 
stands for ugo. If who is omitted, the default is a but the setting of the file creation mask (see umask(2)) is 
taken into account. 


Op can be + to add permission to the file’s mode, — to take away permission and = to assign permission 
absolutely (all other bits will be reset). 


Permission is any combination of the letters r (read), w (write), x (execute), s (set owner or group id) and t 
(save text — sticky). Letters u, g or 0 indicate that permission is to be taken from the current mode. Omit- 
ting permission is only useful with = to take away all permissions. 


The first example denies write permission to others, the second makes a file executable: 


chmod o-—w file 
chmod +x file 


Multiple symbolic modes separated by commas may be given. Operations are performed in the order 
specified. The letter s is only useful with u or g. 


Only the owner of a file (or the super-user) may change its mode. 


SEE ALSO 
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Is(1), chmod(2), stat(2), umask(2), chown(8) 
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NAME 


Eighth Edition CITE(1) 


cite — process citations in a document 


SYNOPSIS 


cite [ -s ] [ -u ] [ document ] 


DESCRIPTION 


Cite is a troff preprocessor used to process forward and backward references in a document. Lines pro- 
cessed by cite can be either of the form 


.CD "key" "definition" 
or 
.CU "key"text 


where key is an arbitrary name for the citation, and definition is what to print when the .CU macro is later 
called. The text following the key in the .CU macro can be any text desired, and it will immediately follow 
the definition. 


In the case of forward references, the program will have no internal definition. Therefore, the program will 
output the line without the internal definition, assuming that later the definition will be provided. In these 
cases, because it is impossible to output the definition, ZZ will be placed on the output followed by the 
additional text. When this definition is entered, the program outputs a line to standard error that gives the 
information on the label; if these definitions are included in the text file and troff is run again on the file, the 
forward references will have the necessary data. 


If -s is an argument to the program, it will do more extensive error checking and sort and print the 
definitions at the end of the program. If -u is an argument to the program, it will place on stderr a list of all 
citations that are either undefined or unused. 


EXAMPLE 
Input: 
Chapter 
.CU "TYPES, OPERATORS AND EXPRESSIONS" 
deals with the basic data types, operators and expressions. 
.CD "TYPES, OPERATORS AND EXPRESSIONS" "2" 
Output: 
First pass: 
Chapter ZZ deals with the basic data types, operators and expressions. 
Second pass: 
Chapter 2 deals with the basic data types, operators and expressions. 
SEE ALSO 
troff(1) 
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NAME 
clear — clear terminal screen 


SYNOPSIS 
clear 


DESCRIPTION 
Clear clears the screen of the terminal on its standard output. It depends upon the environment variable 
TERM to know how to do it. 


FILES 
/etc/termcap 


SEE ALSO 
term(7) 
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NAME 
cmp — compare two files 


SYNOPSIS 
cmp [-1] [-s ] file! file2 


DESCRIPTION 
The two files are compared. (If file/ is ‘—’, the standard input is used.) Under default options, cmp makes 
no comment if the files are the same; if they differ, it announces the byte and line number at which the dif- 
ference occurred. If one file is an initial subsequence of the other, that fact is noted. 


Options: 
-l Print the byte number (decimal) and the differing bytes (octal) for each difference. 
-s Print nothing for differing files; return codes only. 


SEE ALSO 
diff(1), comm(1) 


DIAGNOSTICS 
Exit code 0 is returned for identical files, 1 for different files, and 2 for an inaccessible or missing argument. 
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NAME 

col, 2-6, mc, fold, expand — column alignment 
SYNOPSIS 

col [ —bfx ] 

2 [ file ] 


ind [ prefix ] 

fold [ —N ] [ file ] ... 
me[-][-N][-t] [file]... 
expand [-stops ] [ file ] ... 


DESCRIPTION 


These programs rearrange files for appearance’s sake. All read the standard input and write the standard 
output. Some optionally read from files instead. 


Col overlays lines to expunge reverse line feeds (ESC-7) and half line feeds (ESC-9 and ESC-8) as pro- 
duced by nroff for .2C in ms(7) and for tb/(1). It normally emits only full line feeds; option -f (fine) allows 
half line feeds too. Option —-b removes backspaces, printing just one of each pile of overstruck characters. 
Col normally converts white space to tabs; option —x overrides this feature. Other escaped characters and 
non-printing characters, except for SO and SI, are ignored. 


Col should not be used for printing on an HP ThinkJet printer with think(9.1), which performs the col func- 
tion itself. 


Commands 2, 3, 4, 5, 6 convert their input to 2-, 3-, 4-, 5-, or 6-column form. 


Mc prints in as many columns as will fit on N-column ‘paper’ (default n=S0). If an input line ends in a 
colon *:’, a ‘break’ occurs; thus ‘Is directory! directory2 | mc’ lists each directory separately. This feature 
is suppressed if option — is present, or if input is from a file. On output, multiple spaces are converted to 
tabs; this is suppressed by option -t. 


Expand replaces tabs by spaces. The optional stops argument is a comma-separated of tab stop postions, 
counted from 0; default is every 8 columns. 


Fold inserts newlines after each N characters (default n=80) of long lines. 


EXAMPLE 
tbl file | nroff -ms | col | hp 
FILES 
/etc/termcap 
SEE ALSO 
pr(1) 
BUGS 
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Col can’t back up more than 128 lines or handle more than 800 characters per line, and understands VT 
(013) as reverse line feed. 
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NAME 

comm -— select or reject lines common to two sorted files 
SYNOPSIS 

comm [ -123 ] file! file2 
DESCRIPTION 


Comm reads fileI and file2, which should be ordered in ASCII collating sequence, and produces a three col- 
umn output: lines only in file]; lines only in file2; and lines in both files. The filename ‘—’ means the stan- 
dard input. 
Flags 1, 2, or 3 suppress printing of the corresponding column. Thus comm -12 prints only the lines com- 
mon to the two files; comm —23 prints only lines in the first file but not in the second; comm —123 is a no- 
op. 

SEE ALSO 
cmp(1), diff(1), uniq(1) 
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NAME 
compress, uncompress, zcat — compress and uncompress files 


SYNOPSIS 
compress [ option ] ... [ file] ... 


uncompress [ option ] ... [ file ] ... 
zcat [ file ] ... 


DESCRIPTION 
Compress replaces each file with a compressed verison named file.Z. Modes, dates, and (if possible) owner 
are preserved. If no file is specified, the standard input is compressed onto the standard output. 


Uncompress reverses the operation. 
Zcat uncompresses the files, places the result on the standard output, and leaves the files untouched. 


The options are: 


—c ‘uncompress —c’ means “zcat’. 

-d “compress —d’ means ‘uncompress’. 

-f (force) overwrite output file if it exists. 

-F compress even if output is larger than input. 


-bn use codes up to n bits long; see below. 
-q (quiet) do not report compression ratios. 


Compress uses the Lempel-Ziv algorithm given in the reference. Common substrings in the file are 
replaced by 9-bit codes, then 10-bit codes, and so on until the —-b limit is reached. (The default of 16 can be 
changed in the source to fit a smaller machine.) If the compression ratio does not improve thereafter, 
compress starts afresh with 9-bit codes. 


DIAGNOSTICS 
The exit status is 1 on error, 2 if the last file did not get smaller, 0 otherwise. 


SEE ALSO 
pack(1) 
T. A. Welch, ‘A Technique for High Performance Data Compression,’ IEEE Computer , 17 (1984) 8-19. 


Page | 


COREID (1 ) Eighth Edition COREID (1) 


NAME 
coreid — identify source of core image 
SYNOPSIS 
coreid [ corefile | 
DESCRIPTION 
Coreid reads the file “‘core,’’ or the specified corefile if given, and prints on its standard output the argu- 
ment list of the command which produced the core image. 
FILES 
core 
SEE ALSO 
core(5) 
BUGS 


Only works for core images from C and FORTRAN programs. 
The arguments shown are those at the time of the dump, not at invocation of the command. 
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NAME 
courier — remote procedure call compiler 
SYNOPSIS 
courier [ -x ] specfile 
DESCRIPTION 
Courier compiles the Mesa-like specification language associated with the Courier remote procedure call 
protocol. 
FILES 
prog.cr Courier specification file for prog. 
The following files are generated by courier from the above: 
prog.h definitions and typedefs 
prog stubs.c mappings between C and Courier 
prog server.c server routines 
prog client.c client routines 
BUGS 
Note that program names are restricted to 5 characters to keep generated filenames within the 14 character 
limit. 
SEE ALSO 


Eric C. Cooper, “Writing Distributed Programs with Courier’ 
‘Courier: The Remote Procedure Call Protocol,’ Xerox System Integration Standard 038112, December 
1981. 
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NAME 

cp, rcp — copy 
SYNOPSIS 

cp [-i ] filel file2 


cp [ -i ] file ... directory 
rep file! file2 
rep file ... directory 


DESCRIPTION 
File1 is copied onto file2. The mode and owner of file2 are preserved if it already existed; the mode of the 
source file is used otherwise. 


In the second form, one or more files are copied into the directory with their original file-names. 
Cp refuses to copy a file onto itself. 


If the -i option is specified, cp will prompt the user with the name of the file whenever the copy will cause 
an old file to be overwritten. An answer of ’y’ will cause cp to continue; any other answer will prevent it 
from overwriting the file. 


Rcp (recursive copy) works like cp, but also copies directories and their contents and attempts to duplicate 
linked structures. 


SEE ALSO 
cat(1), mv(1), push(1) 
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NAME 


Eighth Edition CPIO(1) 


cpio — copy file archives in and out 


SYNOPSIS 


cpio -o [ acBv ] 
cpio -i [ BcdmrtuvfsSb6 | [ patterns ] 


cpio —p [ adlmruv ] directory 


DESCRIPTION 


Cpio -o (copy out) reads the standard input to obtain a list of path names and copies those files onto the 
standard output together with path name and status information. 


Cpio -i (copy in) extracts files from the standard input which is assumed to be the product of a previous 
cpio -o. Only files with names that match patterns are selected. Patterns are given in the name-generating 
notation of sh(1). In patterns, meta-characters ?, *, and [...] match the slash / character. Multiple 
patterns may be specified and if no patterns are specified, the default for patterns is * (i.e., select all files). 
The extracted files are conditionally created and copied into the current directory tree based upon the 
options described below. 


Cpio —p (pass) reads the standard input to obtain a list of path names of files that are conditionally created 
and copied into the destination directory tree based upon the options described below. 


The meanings of the available options are: 


Reset access times of input files after they have been copied. 

Input/output is to be blocked 5,120 bytes to the record (does not apply to the pass option; mean- 
ingful only with data directed to or from /dev/rmt?). 

Directories are to be created as needed. 

Write header information in ASCII character form for portability. 

Interactively rename files. If the user types a null line, the file is skipped. 

Print a table of contents of the input. No files are created. 

Copy unconditionally (normally, an older file will not replace a newer file with the same name). 
Verbose: causes a list of file names to be printed. When used with the t option, the table of con- 
tents looks like the output of an Is -—l command (see /s(1)). 

Whenever possible, link files rather than copying them. Usable only with the —p option. 

Retain previous file modification time. This option is ineffective on directories that are being 
copied. 

Copy in all files except those in patterns. 

Swap bytes. Use only with the -i option. 

Swap halfwords. Use only with the -i option. 

Swap both bytes and halfwords. Use only with the -i option. 

Process an old (i.e., UNIX Sixth Edition format) file. Only useful with -i (copy in). 


37 <eer nm oe ms 


ATNA™ 


EXAMPLES 


The first example below copies the contents of a directory into an archive; the second duplicates a directory 
hierarchy: 


Is | cpio —o >/dev/mt0 


cd olddir 
find . —depth —print | cpio —pdl newdir 


The trivial case ‘‘find . —depth —print | cpio —oB >/dev/rmt0’’ can be handled more efficiently by: 
find . —cpio /dev/rmt0 


SEE ALSO 
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ar(1), find(1), cpio(4). 
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BUGS 
Path names are restricted to 128 characters. 
If there are too many unique linked files, the program runs out of memory to keep track of them and, there- 
after, linking information is lost. 
Only the super-user can copy special files. 
The —B option does not work with certain magnetic tape drives. 
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NAME 
crypt, encrypt, decrypt — encode/decode 

SYNOPSIS 
crypt [ password ] 
encrypt [ password ] 
decrypt [ password ] 

DESCRIPTION 
These commands read from the standard input and write on the standard output. The password is an enci- 
phering key. If no password is given, one is demanded from the terminal; echoing is turned off while it is 
being typed in. Crypt uses a relatively simple, fast method (rotor machine) for both enciphering and deci- 
phering. Encrypt and decrypt use a more robust, slower method (Data Encryption Standard). Files enci- 
phered by crypt are compatible with those treated by the editor ed in encryption mode. Files enciphered by 
crypt are not intelligible to decrypt, and vice versa. 
It is prudent to supply the key from the terminal, not from the command line, and to pick a reasonably long 
(6 letters) and unobvious key. Remember, too, that encipherment cannot frustrate adversaries with super- 
user privileges. 

FILES 
/dev/tty for typed key 

SEE ALSO 
ed(1), makekey(8) 

BUGS 
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There is no warranty of merchantability nor any warranty of fitness for a particular purpose nor any other 
warranty, either express or implied, as to the accuracy of the enclosed materials or as to their suitability for 
any particular purpose. Accordingly, Bell Telephone Laboratories assumes no responsibility for their use 
by the recipient. Further, Bell Laboratories assumes no obligation to furnish any assistance of any kind 
whatsoever, or to furnish any additional information or documentation. 
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NAME 
ct — call terminal (and start a session) 


SYNOPSIS 
ct [-c count | [—w interval ] [-h] phone-number [ service-class ] 


DESCRIPTION 
Ct places a telephone call to a remote terminal and allows a user to log in on that terminal in the normal 


fashion. The terminal must be equipped with an auto-answer modem. 


The phone number and service class are interpreted the same way as by cu(1). If ct cannot reach the num- 
ber given, it tries again the number of times given by count (default 5), waiting each time for a given 
interval (default 60 seconds). 


If the —h option is given, ct tries to hang up the phone before placing the call. This is useful for a ‘‘call me 
right back’’ type of arrangement. 
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NAME 


Eighth Edition CU(1) 


cu — call Unix 


SYNOPSIS 


cu [ -tn ] telno [ service-class ] 


DESCRIPTION 
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Cu places a data call to a given telephone number and expects a computer to answer. It manages an interac- 
tive conversation with possible transfers of text files. Telno is the telephone number, consisting of digits 
with minus signs at appropriate places to indicate delay for second or subsequent dial tones. A telephone 
number may also be expressed symbolically. The files SHOME/lib/cunumber and /usr/lib/cunumber are 
searched for lines with up to four fields separated by white space: 


symbolic telephone number 
actual telephone number 
service class (see below) 
comment 


If a comment is present, it is printed out when the connection is made. 
The flag argument —n causes cu merely to print out the the number that would be called, then exit. 


The flag argument -t causes cu to use the DC1/DC3 (“S/Q) protocol to stop transmission from the remote 
system when the local terminal buffers are almost full. This argument should only be used if the remote 
system understands that protocol. 


An optional second command argument specifies a class of service. Locally, one may choose between the 
103-type (slow speed) or 112-type (high-speed) datasets, and perhaps between the Centrex or the data 
Dimension networks. D or D1200 (or just 1200) is 1200 baud on the Dimension system (the default); D300 
is 300 baud Dimension. Systems with their own diallers may allow C1200 and C300 as well, for 1200 and 
300 baud Centrex calls. 


An explicit service class on the command line overrides any specified in a cunumber file. 


After making the connection, cu runs as two processes: the send process reads the standard input and passes 
most of it to the remote system; the receive process reads from the remote system and passes most data to 
the standard output. Lines beginning with ‘’ have special meanings. 


The send process interprets the following: 


terminate the conversation. 
“EOT terminate the conversation 


“~<file send the contents of file to the remote system, as though typed at the terminal. 


“ invoke an interactive shell on the local system. 


“lemd ... run the command on the local system (via sh -c). 

“$cmd ... run the command locally and send its output to the remote system. 

Dd 

~%break are identical, and cause a break (300 ms. space) to be sent. 

~%take from [to] copy file ‘from’ (on the remote system) to file ‘to’ on the local system. If ‘to’ is 


omitted, the ‘from’ name is used both places. 


~%put from [to] copy file ‘from’ (on local system) to file ‘to’ on remote system. If ‘to’ is omitted, the 
‘from’ name is used both places. 


r) 


send the line “...’. 
The receive process handles output diversions of the following form: 


“>[>][:]file 
zero or more lines to be written to file 
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> 
Output is diverted (or appended, if ‘>>’ used) to the file. If ‘:’ is used, the diversion is silent, i.e., it is writ- 
ten only to the file. If ‘:’ is omitted, output is written both to the file and to the standard output. The trail- 
ing “>’ terminates the diversion. 
The receive process also recognizes lines of the form 
~!command 
or 
~:!command 
which cause command to be executed locally. If the *:’ is present the line is not printed before execution. 
The use of ~% put requires stty and cat on the remote side. It also requires that the current erase and kill 
characters on the remote system be identical to the current ones on the local system. Backslashes are 
inserted at appropriate places. 
The use of ~%take requires the existence of echo and tee on the remote system. Also, stty tabs mode is 
required on the remote system if tabs are to be copied without expansion. 

FILES 
/usr/lib/cunumber, $HOME/lib/cunumber 

SEE ALSO 
dn(4), ttyld(4), dialout(3) 

DIAGNOSTICS 
Exit code is zero for normal exit, nonzero (various values) otherwise. 

BUGS 


The syntax is unique. The speed option (—s) should be put back (it is at least partially independent of the 
class of service). 


“lis a friend to the malicious. 
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NAME 


Eighth Edition CUT(1) 


cut, paste — rearrange columns of data 


SYNOPSIS 


cut —clist [ file ... ] 
cut —flist [ -dchar ] [ file ... ] 
paste [ -s ] [ -dlist ] file ... 


DESCRIPTION 


Cut selects fields from each line of the files (standard input default). In data base parlance, it projects a rela- 
tion. The fields can be fixed length, as on a punched card (—e option), or be marked with a delimiter charac- 
ter (-f option). 


The meanings of the options follow. A /ist is a comma-separated, increasing list of integers with optional — 
to indicate ranges, for example 1,3-5,7. 

-clist The list specifies character positions. 

-flist | The /ist specifies field numbers. 

-dchar The character is the delimiter for the -f option. Default is tab. 


-Ss Suppress lines with no delimiter characters in case of -f option. Normally such lines pass through 
untouched. 

Paste concatenates corresponding lines of the input files and places the result on the standard output. The 

file name ‘—’ refers to the standard input. Lines are glued together with tab characters, or with characters 

taken circularly from an optionally specified list. The list may contain the special escape sequences \n 

(newline), \t (tab), \\ (backslash), and \0 (empty string, not a null character). 


Option -s causes paste to combine successive lines from one file rather than corresponding lines from mul- 
tiple files. 


EXAMPLES 


cut —d: -f1,3 /etc/passwd 
mapping of login names to userids 


NAME=‘who am i | cut -f1 -d" "‘ 
set NAME to current login name (subtly different from ‘getuid’) 


Is | paste ——-—— 
Is | paste —s —d\t\n’ — 
4-column and 2-column file listing 


SEE ALSO 


BUGS 
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grep(1), awk(1), sed(1), pr(1), column(1) 


Cut should handle disordered lists. 
In default of file names, paste should read the the standard input. 
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NAME 


cyntax, cem — C syntax checker 


SYNOPSIS 


cyntax [ options ] ... files ... 


/usr/lib/cyntax/cem [ options ] ... files ... 


DESCRIPTION 


FILES 


Cyntax is a C compiler front end. Cem (cemantics) is a link editor for cyntax. Together they obsolete 
lint (1). 


Cyntax assumes that files whose names end with ‘.c’ are C source programs; they are compiled to an object 
file whose name is that of the source with ‘.O’ substituted for ‘.c’. If all goes well it will invoke the link 
editor on the resulting object files plus any arguments whose names end with ‘.O’. Object files contain type 
information — no code. 


Options —D, -I, -U, -o, -] are as in cc(1). Options —O, —-g, and -p are ignored. Other options are: 


—c Suppress link editing. 

-h Base object files on the basename of the source file rather than the full pathname. 

-j Change default directory of include files to ‘/usr/jerq/include’. 

-w Enable pedantic warning diagnostics. 

—m equivalent to ‘“-j -DMUX’. 

-v Report what cyntax is actually doing. 

-Vfuncin 
Declare function func to have a variable number of arguments, the first n of which are to be type 
checked. 


Cem is normally invoked only by cyntax. It also has options, some of which cyntax can’t be coerced into 
providing. Besides —o and -l already mentioned, they are: 


—m Don’t believe file modification times. These are normally used to avert redundant type checking. 


-p Be pedantic about type checking. 


-t Unconditionally include file modification times in diagnostics. 
-v Use a verbose format for type names. 

*.C 

*.O 

a.out 


/media/acher/Games/v8/usr/include/* 
In /usr/lib/cyntax: 
ccom cyntax proper 


cem cemantics 
libe type library 
libj 

SEE ALSO 
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cc(1), Id(1), lint(1) 
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NAME 


Eighth Edition D202(1) 


d202, daps, dcan, tc — phototypesetter filters 


SYNOPSIS 
d202 


e202 


daps [ option 


dcan 


[ 
[ 
[ 
[ 


option ] ... [ file ] ... 
option ] ... [ file] ... 

] ... [ file ] ... 
option ] ... [ file] ... 


te [ option ] ... [ file ] ... 


DESCRIPTION 


D202 and its companions print files created by troff(1) on various devices: 


d202 
e202 
daps 
dcan 
tc 


Mergenthaler Linotron 202 

same, with half-tone and extra graphics capability 
Autologic APS-5 phototypesetter 

Imagen Canon LBP-10 laser printer, 

Tektronix 4014 display 


If no file is mentioned, the standard input is printed. The following options are understood. 


-b 


-olist 


Report whether the typesetter is busy; do not print. 


Print pages whose numbers are given in the comma-separated list. The list contains comma- 
separated numbers N and ranges N/—N2. A missing N/ means the lowest-numbered page, a miss- 
ing N2 means the highest. 


Stop after every n pages of output. (Default 1 on 4014). Proceed when the RUN button is pushed 
on the typesetter, (for d202) or newline on the terminal (for 40/4). 


Direct output to the standard output instead of the typesetter. Don’t wait between pages in tc. 
Wait for typesetter to become free, then print. 

Take font information from directory dir instead of the default. 

Change default precision of dots to n to use less precious memory. Dcan only. 


Set the aspect ratio to r (default r=1.5). Tc only. 


The files for daps should be prepared under the -Taps option of troff; dcan and tc are intended as typesetter 
simulators, and can cope with anything. 


While waiting between pages tc accepts !command to insert a shell command; +n to skip forward n pages; 
—n to skip backwards n pages; ar to set the aspect ratio; and ? to print the list of available actions. 


FILES 


/usr/lib/font/dev202/* 202 description files 
/usr/lib/font/dev APS/* aps-5 description files 
/ust/lib/font/devcan/* Canon description and raster character files 


SEE ALSO 


troff(1), can(1), proof(9.1), apsend(1) 
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NAME 


date — print and set the date 


SYNOPSIS 


date [ yymmddhhmm [.ss ] ] 


DESCRIPTION 


FILES 


If no argument is given, the current date and time are printed. If an argument is given, the current date is 
set. yy is the last two digits of the year; the first mm is the month number; dd is the day number in the 
month; hh is the hour number (24 hour system); the second mm is the minute number; .ss is optional and is 
the seconds. For example: 


date 10080045 


sets the date to Oct 8, 12:45 AM. The year, month and day may be omitted, the current values being the 
defaults. The system operates in GMT. Date takes care of the conversion to and from local standard and 
daylight time. 


/usr/adm/wtmp to record time-setting 


SEE ALSO 


utmp(5) 


DIAGNOSTICS 
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‘No permission’ if you aren’t the super-user and you try to change the date; ‘bad conversion’ if the date set 
is syntactically incorrect. 
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NAME 
DB — database command interface 


SYNOPSIS 
DB [-D ] [-c ] -ffilename [ -L ] [-t | -1] [ -kkey [-ddata ] ] [-g | -p | -r | -a | 4] [-U]... 
DESCRIPTION 


DB provides a command-level interface to the DB(3) routines (q.v.). 


The options and their meanings are: 315116.sp48u 
-D Increment debugging level. Currently there are 4 levels of debugging, ranging from conditions 
that cause a core dump to a call trace of the user-accessible routines in the DB library. 


-L Set an advisory lock on the database. 
—U Clear an advisory lock on the database. 
-c Create (or truncate) the named database. 
-ffilename 


Names the database. 
-t Produce a table of contents of the database. 
-l Produce a listing of the keys and records of the database. 
-kkey Set the value of the current key. 


-ddata Set the value of the current data. 


-p Put the current data at the current key. 

-g Get (and print) the data at the current key. 

-r Remove (delete) the data at the current key. 

-a Append the current data to the data stored at the current key. 

-i Insert the current data in front of the data stored at the current key. 
SEE ALSO 

DB(3), DBcp(1), DBcvt(1). 
DIAGNOSTICS 


The diagnostics are intended to be self-explanatory. Mostly, they’re complaints about missing arguments. 


BUGS 
Nonascii characters cannot be passed to DB because the shell strips the 8th (most significant) bit. 
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NAME 
DBcp — database copy 


SYNOPSIS 
DBep source dest 


DESCRIPTION 
DBcp copies a database created with either DB(1) or the DB(3) routines. DBcp performs the copy by iterat- 
ing through the keys using the routines DBkeyO and DBkeyn, found in the DB library. 


This is a separate command because of the high probability of empty blocks in the database; these blocks 
are not copied. 


SEE ALSO 
DB(1), DB(3), DBcvt(1). 
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NAME 

DBcvt — convert a database file between 3B and VAX formats 
SYNOPSIS 

DBcvt source 
DESCRIPTION 


DBcvt converts a database file between 3B and VAX formats. Although the conversion is performed ‘in 
place,’ if the process is interrupted or fails for some other reason, the source file is unaffected, and in rare 
cases, a file named source.cvt may remain. The exit code is 0 on success, | in other cases. 


SEE ALSO 
DB(1), DBcp(1), DB(3). 
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NAME 


DESCRIPTION 
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Eighth Edition DC(1) 


de — desk calculator 


SYNOPSIS 
de [ file ] 


De is an arbitrary precision arithmetic package. Ordinarily it operates on decimal integers, but one may 
specify an input base, output base, and a number of fractional digits to be maintained. The overall structure 
of dc is a stacking (reverse Polish) calculator. If an argument is given, input is taken from that file until its 
end, then from the standard input. The following constructions are recognized: 


number 


The value of the number is pushed on the stack. A number is an unbroken string of the digits 0-9. 
It may be preceded by an underscore _ to input a negative number. Numbers may contain decimal 
points. 


+-/* %~ 


Sx 


The top two values on the stack are added (+), subtracted (—), multiplied (*), divided (/), remain- 
dered (%), or exponentiated (“). The two entries are popped off the stack; the result is pushed on the 
stack in their place. Any fractional part of an exponent is ignored. 


The top of the stack is popped and stored into a register named x, where x may be any character. If 
the s is capitalized, x is treated as a stack and the value is pushed on it. 


The value in register x is pushed on the stack. The register x is not altered. All registers start with 
zero value. If the I is capitalized, register x is treated as a stack and its top value is popped onto the 
main stack. 


The top value on the stack is duplicated. 


The top value on the stack is printed. The top value remains unchanged. P interprets the top of the 
stack as an ascii string, removes it, and prints it. 


All values on the stack and in registers are printed. 


exits the program. If executing a string, the recursion level is popped by two. If q is capitalized, the 
top value on the stack is popped and the string execution level is popped by that value. 


treats the top element of the stack as a character string and executes it as a string of dc commands. 
replaces the number on the top of the stack with its scale factor. 
puts the bracketed ascii string onto the top of the stack. 


=x 
The top two elements of the stack are popped and compared. Register x is executed if they obey the 
stated relation. 


replaces the top element on the stack by its square root. Any existing fractional part of the argument 
is taken into account, but otherwise the scale factor is ignored. 


interprets the rest of the line as a UNIX command. 
All values on the stack are popped. 


The top value on the stack is popped and used as the number radix for further input. I pushes the 
input base on the top of the stack. 


The top value on the stack is popped and used as the number radix for further output. 
pushes the output base on the top of the stack. 


the top of the stack is popped, and that value is used as a non-negative scale factor: the appropriate 
number of places are printed on output, and maintained during multiplication, division, and expo- 
nentiation. The interaction of scale factor, input base, and output base will be reasonable if all are 
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changed together. 
Z The stack level is pushed onto the stack. 
Z replaces the number on the top of the stack with its length. 
? A line of input is taken from the input source (usually the terminal) and executed. 
ar are used by bc for array operations. 


An example which prints the first ten values of n! is 


[lal+dsa*plal0>y]sy 
Osal 
lyx 


SEE ALSO 


bce(1), which is a preprocessor for dc providing infix notation and a C-like syntax which implements func- 
tions and reasonable control structures for programs. 


DIAGNOSTICS 
“x is unimplemented’ where x is an octal number. 
‘stack empty’ for not enough elements on the stack to do what was asked. 
‘Out of space’ when the free list is exhausted (too many digits). 
‘Out of headers’ for too many numbers being kept around. 
‘Out of pushdown’ for too many items on the stack. 
‘Nesting Depth’ for too many levels of nested execution. 
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NAME 
dcon, ndcon, rx, rogin, rsh — remote login and execution 
SYNOPSIS 

dcon [ option ] ... machine 

ndcon machine 

rx machine [ command-list | 

/usr/bin/m/machine [ command-list ] 

/usr/inet/bin/rogin machine [ -] username ] 

/usr/inet/bin/rsh machine [ —I username ] [ command-list ] 

DESCRIPTION 

Deon logs in to the computer whose Datakit address is machine. It is much like cu(1), but the only local 

escapes are hang up “.’ and a shell escape “!’. 

Dcon normally tries to log in automatically, using the login id of the invoking user. To login explicitly, or 

to connect to machines that disallow such access, use option -I. Other options are: 

-v Verbose. Give play-by-play while logging in. 

-s Script. The machine argument names a file that guides login. The first line of the file is the 
machine name. Later lines are paired: a prompt word expected from the remote machine (includ- 
ing nonblank punctuation), with an input line to send upon receiving that prompt. All other words 
received while looking for prompts are ignored. 

Ndcon logs in to a remote computer similarly to dcon, but with a direct stream(4)-to-stream connection. In 

particular mux(9) layers may be downloaded across it. The only local escape is the quit signal (control-\). 

Legitimate answers to the subsequent prompt ‘dcon>>’ are ‘i’ [sic] to send the quit signal to the remote 

machine, ‘x’ or *.’ to exit ndcon, and ‘!command-list’ to execute commands locally. 

Rx invokes a shell on the designated machine and passes the command-list to that shell. The standard input 

and output of the remote process are the standard input and output of rx. The standard error file from the 

remote process is the same as the standard output. The current directory, permissions and shell variables of 
the remote shell are what the user would get by logging in directly. Unquoted shell metacharacters are 
interpreted locally; quoted ones are interpreted on the remote machine. 

Rx with no command-list is equivalent to “dcon machine’. 

Directory /usr/bin/m contains machine names as commands: ‘/usr/bin/m/machine’ with no argument gets an 

ndcon connection; with arguments it does rx. If the directory is in the sh(1) search path, the names become 

commands for navigating the local cluster. 

Rogin and rsh are to ARPA internet as dcon and rx are to Datakit. A file ‘.rhosts’ in the login directory for 

username on a receiving machine lists machine/user pairs that may log in as username without a password 

check. Pairs appear one per line separated by blanks. 
EXAMPLES 

rx overthere cat filel > file2 
copies remote file/ to local file2; for other ways to do the job, see push(1) and nfs (5) 

rx overthere cat filel ">" file2 
copies remote file/ to remote file2 

FILES 

/asr/inet/lib/* 

/usr/inet/lib/hosts.equiv list of machines with identical users 

$HOME/.rhosts 

BUGS 
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Dcon’s function properly belongs in cu(1). 
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Response ‘q’ to ndcon’s quit-signal prompt causes a local exit, not a remote quit signal. 

Scripts for the -s option typically contain passwords in the clear. This will compromise the security of the 
remote machine unless the login reaches a restricted environment. Scripts are not the same as those for 
uucp(1). 

The machine arguments of these commands are Datakit addresses, while the names in /usr/bin/m are short- 
hand — usually the last component of an address. Thus on the machine ‘astro/grigg’, the machine 
‘bistro/polya’ will be called “bistro/polya’ in dcon, ndcon and rx, but will be simply ‘polya’ in the naviga- 
tion command. 


Page 2 


DD(1) Eighth Edition DD(1) 
NAME 
dd — convert and copy a file 
SYNOPSIS 
dd [option=value] ... 
DESCRIPTION 
Dd copies the specified input file to the specified output with possible conversions. The standard input and 
output are used by default. The input and output block size may be specified to take advantage of raw 
physical I/O. 
option values 
if=file input file name; standard input is default 
of=file output file name; standard output is default 
ibs=n input block size n bytes (default 512) 
obs=n output block size (default 512) 
bs=n set both input and output block size, superseding ibs and obs; also, if no conversion is 
specified, preserve the input block size instead of packing short blocks into the output buffer. 
This is particularly efficient since no in-core copy need be done. 
cbs=n conversion buffer size 
skip=n skip n input records before starting copy 
files=n copy and concatenate n input files before terminating (makes sense only where input is a 
magtape or similar device). 
seek=n seek n records from beginning of output file before copying 
count=n copy only n input records 
conv=ascii convert EBCDIC to ASCII 
ebcdic convert ASCII to EBCDIC 
ibm _ slightly different map of ASCII to EBCDIC 
block convert variable length ASCII records to fixed length 
unblock 
convert fixed length ASCII records to variable length 
Icase_ map alphabetics to lower case 
ucase map alphabetics to upper case 
swab swap every pair of bytes 
noerror 
do not stop processing on an error 
syne pad every input record to ibs 
eeeyee. Several comma-separated conversions 
Where sizes are specified, a number of bytes is expected. A number may end with k, b, or w to specify 
multiplication by 1024, 512, or 2 respectively; a pair of numbers may be separated by x to indicate a prod- 
uct. 
Cbs is used only if ascii, unblock , ebcdic , ibm, or block conversion is specified. In the first two cases, cbs 
characters are copied into the conversion buffer, any specified character mapping is done, trailing blanks are 
trimmed and new-line is added before sending the line to the output. In the latter three cases, characters are 
read into the conversion buffer and blanks are added to make up an output record of size cbs. If cbs is 
unspecified or zero, the ascii, ebcdic , and ibm options convert the character set without changing the block 
structure of the input file; the unblock and block options become a simple file copy. 
After completion, dd reports the number of whole and partial input and output blocks. 
EXAMPLE 
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dd if=/dev/rmtO of=x ibs=800 cbs=80 conv=ascii,lcase 
Read an EBCDIC tape blocked ten 80-byte EBCDIC card images per record into an ASCII file. Note 
the use of raw magtape to handle arbitrary record sizes. 
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SEE ALSO 

cp(1), tar(1), epio(1) 
DIAGNOSTICS 

+p records in(out) numbers of full and partial records read(written) 
BUGS 


The ASCII/EBCDIC conversion tables are taken from the 256 character standard in the CACM Nov, 1968. 


The ibm conversion, while less blessed as a standard, corresponds better to certain IBM print train conven- 
tions. There is no universal solution. 
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NAME 


deroff — remove formatting requests 


SYNOPSIS 


deroff [ option ... ] file ... 


DESCRIPTION 


Deroff reads each file in sequence and removes all nroff and troff command lines, backslash constructions, 
macro definitions, egn constructs (between ‘.EQ’ and ‘.EN’ lines or between delimiters), ¢b/ table descrip- 
tions, pic constructs, and refer references. Remaining text is written on the standard output. Deroff follows 
chains of included files (‘.so’ and ‘.nx’ commands); if a file has already been included, a ‘.so’ is ignored 
and a ‘.nx’ terminates execution. If no input file is given, deroff reads from the standard input file. 


The options are 


-w Output a word list, one ‘word’ (string of letters, digits, and apostrophes, beginning with a letter; 
apostrophes are removed) per line, and all other characters ignored. Otherwise, the output follows 
the original, with the deletions mentioned above. 


-i Ignore *.so’ and ‘.nx’ requests. 


—Mms, -mm 
Follow the conventions of ms(7) or mm macros. 


-ml Follow the conventions of mm and suppress lists. 


SEE ALSO 


BUGS 
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troff(1), eqn(1), tbl(1), pic(1), refer(1) 


Deroff is not a complete troff interpreter; it can be confused. In particular, troff macro definitions contain- 
ing ‘\$’ cause chaos when the popular ‘$$’ delimiters for eqn are in effect. 
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NAME 
df — disk free 


SYNOPSIS 
df [ -i ] [-1] [ filesystem ... ] [ directory ... ] 


DESCRIPTION 
Df prints out the amount of free space on filesystem, e.g. “‘/dev/rp0a’’, or on the filesystem in which the 
specified directory, e.g. ‘““SHOME”’, is contained. If no file system is specified, the free space on all of the 
normally mounted file systems is printed. 


The reported numbers are in kilobytes, independent of the blocksize actually used on the filesystem. 


Other options are: 


=i Report also the number of inodes which are used and free. 
| examines also the free list, double checking that the summary number in the filesystem superblock 
is correct. 
FILES 
/etc/fstab list of normally mounted filesystems 
/etc/mtab list of currently mounted filesystems 
SEE ALSO 


fstab(5), mtab(5), icheck(8), quot(8) 
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diff — differential file comparison 


SYNOPSIS 


diff [ -1 ] [-r ] [-s ] | -cefh ] [ -b ] dirl dir2 
diff [ -cefh ] [ -b ] file! file2 
diff [ —Dstring | [ -b ] file1 file2 


DESCRIPTION 
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If both arguments are directories, diff sorts the contents of the directories by name, and then runs the regular 
file diff algorithm (described below) on text files which are different. Binary files which differ, common 
subdirectories, and files which appear in only one directory are listed. Options when comparing directories 
are: 


-l long output format; each text file diff is piped through pr(1) to paginate it, other differences are 
remembered and summarized after all text file differences are reported. 

—r causes application of diff recursively to common subdirectories encountered. 

-s causes diff to report files which are the same, which are otherwise not mentioned. 

—Sname 


starts a directory diff in the middle beginning with file name. 


When run on regular files, and when comparing text files which differ during directory comparison, diff 
tells what lines must be changed in the files to bring them into agreement. Except in rare circumstances, 
diff finds a smallest sufficient set of file differences. If neither file/ nor file2 is a directory, then either may 
be given as ‘—’, in which case the standard input is used. If file/ is a directory, then a file in that directory 
whose file-name is the same as the file-name of file2 is used (and vice versa). 


There are several options for output format; the default output format contains lines of these forms: 


nl an3,n4 
nl,n2 dn3 
nl,n2 cn3,n4 


These lines resemble ed commands to convert file/ into file2. The numbers after the letters pertain to file2. 
In fact, by exchanging ‘a’ for ‘d’ and reading backward one may ascertain equally how to convert file2 into 
filel. As in ed, identical pairs where n/J = n2 or n3 = n4 are abbreviated as a single number. 


Following each of these lines come all the lines that are affected in the first file flagged by ‘<’, then all the 
lines that are affected in the second file flagged by ‘>’. 


Except for —-b, which may be given with any of the others, the following options are mutually exclusive: 


-e producing a script of a, c and d commands for the editor ed, which will recreate file2 from file/. 
In connection with -e, the following shell program may help maintain multiple versions of a 
file. Only an ancestral file ($1) and a chain of version-to-version ed scripts ($2,$3,...) made by 
diff need be on hand. A ‘latest version’ appears on the standard output. 


(shift; cat $*; echo *1,$p*) | ed-$1 


Extra commands are added to the output when comparing directories with —e, so that the result 
is a sh(1) script for converting text files which are common to the two directories from their 
state in dir/ to their state in dir2. 


-f produces a script similar to that of -e, not useful with ed, and in the opposite order. 


-c produces a diff with lines of context. The default is to present 3 lines of context and may be 
changed, e.g to 10, by -c10. With —c the output format is modified slightly: the output begin- 
ning with identification of the files involved and their creation dates and then each change is 


separated by a line with a dozen *’s. The lines removed from file] are marked with ‘—’; those 
added to file2 are marked ‘+’. Lines which are changed from one file to the other are marked in 
both files with ‘!’. 
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—h does a fast, half-hearted job. It works only when changed stretches are short and well separated, 
but does work on files of unlimited length. 


—-Dstring causes diff to create a merged version of file/ and file2 on the standard output, with C preproces- 
sor controls included so that a compilation of the result without defining string is equivalent to 
compiling file/, while defining string will yield file2. 


-b causes trailing blanks (spaces and tabs) to be ignored, and other strings of blanks to compare 
equal. 

FILES 

/tmp/d????? 

/asr/lib/difth for —h 

/usr/bin/pr 
SEE ALSO 

cmp(1), cc(1), comm(1), ed(1), diff3(1), idiff(1) 
DIAGNOSTICS 

Exit status is O for no differences, 1 for some, 2 for trouble. 
BUGS 


Editing scripts produced under the -e or -f option are naive about creating lines consisting of a single ‘.’. 


When comparing directories with the —b option specified, diff first compares the files ala cmp, and then 
decides to run the diff algorithm if they are not equal. This may cause a small amount of spurious output if 
the files then turn out to be identical because the only differences are insignificant blank string differences. 
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NAME 


diff3 — 3-way differential file comparison 


SYNOPSIS 


diff3 [ -ex3 ] filel file2 file3 


DESCRIPTION 


Diff3 compares three versions of a file, and publishes disagreeing ranges of text flagged with these codes: 


———— all three files differ 


====] file1 is different 
====2 file2 is different 
====3 file3 is different 


The type of change suffered in converting a given range of a given file to some other is indicated in one of 
these ways: 


finla Text is to be appended after line number n/ in file f, where f= 1, 2, or 3. 


finl ,n2¢ Text is to be changed in the range line n/ to line n2. If nl = n2, the range may be 
abbreviated to n/. 


The original contents of the range follows immediately after a c indication. When the contents of two files 
are identical, the contents of the lower-numbered file is suppressed. 


Under the -e option, diff3 publishes a script for the editor ed that will incorporate into file/ all changes 
between file2 and file3, i.e. the changes that normally would be flagged ==== and ====3. Option —x (-3) 
produces a script to incorporate only changes flagged ==== (====3). The following command will apply 
the resulting script to ‘filel’. 


(cat script; echo “1,$p’) | ed — filel 
FILES 
/tmp/d3????? 
/ust/lib/diff3 
SEE ALSO 


BUGS 
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diff(1), idiff(1) 


Text lines that consist of a single *.’ will defeat -e. 
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NAME 


dired — directory editor 


SYNOPSIS 


dired [ option ... ] [ dir-name | file-list | 


DESCRIPTION 
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Dired displays a directory listing like ‘ls —-l’ (see /s(1)) and allows you to prowl around the listed entries, 
deleting, editing, and displaying them. Dired must know what kind of terminal you are using; the environ- 
ment variable TERM should be set (see term(7)). 


With no argument, the current directory is listed. With only one argument, the argument is interpreted as a 
directory and it is listed. With multiple arguments, the arguments are interpreted as filenames. 


Options are: 


—[sr][nsrw] 
Sort or reverse sort by Name, Size, Read date, or Write date respectively. 


—wn If n is f, use the full screen; if h, use half the screen (default); if a number, use n lines for the direc- 
tory listing , reserving the rest of the screen for quick file display. 


The fields of a dired listing are: mode, link count, owner, size, write date and name. A cursor shows the 
current entry. 


Commands consist of single characters; arguments are prompted for, and echoed, in the bottom line of the 
screen. The commands are: 


<ci> 

<lf> 

“N Step to the next file. 

<backspace> 

“P Step to previous file. 

! Prompt for a shell command. The command is executed, and confirmation is required before 
returning to the display. All ‘%’ characters in the command are replaced with the pathname of the 
current entry, and all ‘# characters are replaced with the trailing filename component (what you 
see on the screen). 

Repeats the previous ! shell command, substituting the current entry for any special characters 
(%#) in the original command. 

a Abort this directory level of dired without deleting any files. 

b Step one page backward in the directory listing. 

c Refresh the current line. 

d Mark the current entry for deletion. Deletion of a directory is recursive. 

e If the current entry is a file, edit it with the editor ‘e’, or another editor named by the environment 
variable EDITOR. If the current entry is a directory, descend (by forking) to list that directory. 

f Step one page forward in the directory listing. 

h 

? Display a help file. 

] 


“L Refresh the display. 


m Display the current file with the pager p(1), or another pager named by the environment variable 
PAGER. (Supply your own etymology for ‘m’.) 
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Print the current file on the line printer. 


Quit this directory level of dired. List the files marked for deletion and request confirmation before 
deleting them. 


bay? 6G 


Sort the file list by various fields: name, read date, size, write date, denoted ‘n’, ‘r’, ‘s’, and ‘w’. 
Default sort is by name. Ordering for s is increasing if by name, decreasing if by size or date. 
Ordering for r is opposite. A sort can be stopped with *G. 


Type. Display the current file. In two-window mode pause after each screenfull until you type a 
carriage return. The display may be interrupted by “C or “q’. 


Same as t but without any pauses. 


Unmark the current entry if it was marked for deletion. 


/usr/lib/dired help file for ‘?’ and ‘h’ 


Ipr(1) 


SEE ALSO 
Is(1) 


DIAGNOSTICS 


line printer 


While dired is preparing a listing it reports, ‘Reading,’ and types a dot for each 10 files. 


BUGS 


Long lines and diagnostics can foul up the display. 
Needs a command to search for a given file. 
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NAME 

docgen — generate a document from a script 
SYNOPSIS 

docgen [ option ] ... [ ofile ] 
DESCRIPTION 


Docgen guides interactive preparation of standard documents according to canned scripts and places the 
output in ofile. The output typically takes the form of troff(1) input. These options invoke standard scripts: 


-mcs___ Bell Labs cover sheet; output (“temp.cover’ by default) may be typeset thus: troff temp.cover 


—ms (default) all kinds of document known to the macro package ms(7); output (‘temp’ by default) may 
be typeset thus: troff—ms temp 


-mm _ similarly for the MM macro package of System V 
Other options are: 

-ffile take script from file 

-v (verbose) print document as it is generated 

-d (debug) print information about the script as it is read 


The reference tells how to construct scripts. 


FILES 
/usr/lib/docgen/* scripts 
temp.cover 
temp 

SEE ALSO 


troff(1), ms(7), mcs(7) 
L. L. Cherry, Docgen, AT&T Bell Laboratories, 1980 


BUGS 
Not all document types are implemented. 
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NAME 

doctype — guess command line for formatting a document 
SYNOPSIS 

doctype [ -e ] [ file] ... 
DESCRIPTION 


Doctype guesses the command line necessary for printing a document that uses troff(1), related preproces- 
sors like eqn, and the —-ms and —mm macro packages. The optional argument —e causes the command line 
to be executed. 


SEE ALSO 
troff(1), eqn(1), tbl(1), refer(1), pic(1), ideal(1), grap(1), ms(7), mm(7) 


BUGS 
It’s pretty dumb about guessing the proper macro package. 
There is no way to supply non-filename arguments when -e is used. 


Page | 


DU(1) Eighth Edition DU(1) 


NAME 

du — summarize disk usage 
SYNOPSIS 

du [-s ][-a ][ name... ] 
DESCRIPTION 


Du gives the number of kilobytes (kilo=1024) allocated to data blocks of named files and of named directo- 


a) 


ries including (recursively) their contents. If name is missing, ‘.’ is used. 


Option —s causes only the grand total to be given. Option —a causes an entry to be generated for each file. 
Absence of either causes an entry to be generated for each directory only. 


A file which has two links to it is counted only once. 


SEE ALSO 
df(1), quot(8) 
BUGS 
In the absence of option —a non-directories given as arguments are not listed. 
If there are too many distinct linked files, du counts the excess files multiply. 
Unwritten holes in files count as if real data were present, and indirect blocks are not counted. 
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NAME 

echo — echo arguments 
SYNOPSIS 

echo [-n ] [-e] [ arg]... 
DESCRIPTION 


Echo writes its arguments separated by blanks and terminated by a newline on the standard output. Option 
—n suppresses the newline. 


Option —e enables the interpretation of C-style escape codes, \b, \f, \n, \r, \t, \\, and \ddd, where d is an octal 
digit, plus the special code \c, which terminates the output. 


Echo is useful for producing diagnostics in shell programs and for writing constant data on pipes. To send 
diagnostics to the standard error file, do “echo ... 1>&2’. 
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NAME 
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ed — text editor 


SYNOPSIS 


ed [-][-o][-X] [name ] 


DESCRIPTION 


Page | 


Ed is the standard text editor. 


If a name argument is given, ed simulates an e command (see below) on the named file; that is to say, the 
file is read into ed’s buffer so that it can be edited. If —X is present, an X command is simulated first to han- 
dle an encrypted file. The optional — suppresses the printing of character counts by e, 7, and w commands 
and the confirming ‘!’ by / commands. If -o is present, ed writes all its interactive output on the standard 
error file instead of the standard output file, starts with /dev/stdout as its default output file, ignores any 
input file argument, suppresses printing of character counts, and simulates an initial a command. 


Ed operates on a copy of any file it is editing; changes made in the copy have no effect on the file until a w 
(write) command is given. The copy of the text being edited resides in a temporary file called the buffer. 


Commands to ed have a simple and regular structure: zero or more addresses followed by a single character 
command, possibly followed by parameters to the command. These addresses specify one or more lines in 
the buffer. Missing addresses are supplied by default. 


In general, only one command may appear on a line. Certain commands allow the addition of text to the 
buffer. While ed is accepting text, it is said to be in input mode. In this mode, no commands are recog- 
nized; all input is merely collected. Input mode is left by typing a period *.’ alone at the beginning of a line. 


Ed supports a limited form of regular expression notation. A regular expression specifies a set of strings of 
characters. A member of this set of strings is said to be matched by the regular expression. In the follow- 
ing specification for regular expressions the word ‘character’ means any character but newline. 


1. Any character except a special character matches itself. Special characters are the regular expres- 
sion delimiter plus \[. and sometimes ** $. 


2. A .. matches any character. 
A \ followed by any character except a digit or () matches that character. 


4. A nonempty string s bracketed [s ] (or [*s ]) matches any character in (or not in) s. In s, \ has no 
special meaning, and ] may only appear as the first letter. A substring a—b, with a and b in ascend- 
ing ASCII order, stands for the inclusive range of ASCII characters. 


5. A regular expression of form 1-4 followed by * matches a sequence of 0 or more matches of the 
regular expression. 


A regular expression, x, of form 1-8, bracketed \(x \) matches what x matches. 


A \ followed by a digit n matches a copy of the string that the bracketed regular expression begin- 
ning with the nth \( matched. 


8. A regular expression of form 1-8, x, followed by a regular expression of form 1-7, y matches a 
match for x followed by a match for y, with the x match being as long as possible while still per- 
mitting a y match. 


9. A regular expression of form 1-8 preceded by * (or followed by $), is constrained to matches that 
begin at the left (or end at the right) end of a line. 
10. A regular expression of form 1-9 picks out the longest among the leftmost matches in a line. 


11. An empty regular expression stands for a copy of the last regular expression encountered. 


Regular expressions are used in addresses to specify lines and in one command (see s below) to specify a 
portion of a line which is to be replaced. If it is desired to use one of the regular expression metacharacters 
as an ordinary character, that character may be preceded by ‘\’. This also applies to the character bounding 
the regular expression (often ‘/’) and to ‘\ itself. 
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To understand addressing in ed it is necessary to know that at any time there is a current line. Generally 
speaking, the current line is the last line affected by a command; however, the exact effect on the current 
line is discussed under the description of the command. Addresses are constructed as follows. 


1. The character ‘.’ addresses the current line. 

2 The character ‘$’ addresses the last line of the buffer. 

3, A decimal number n addresses the n-th line of the buffer. 
4 


‘’x’ addresses the line marked with the name x, which must be a lower-case letter. Lines are 
marked with the k command described below. 


5. A regular expression enclosed in slashes ‘/’ addresses the line found by searching forward from the 
current line and stopping at the first line containing a string that matches the regular expression. If 
necessary the search wraps around to the beginning of the buffer. 


6. A regular expression enclosed in queries ‘?’ addresses the line found by searching backward from 
the current line and stopping at the first line containing a string that matches the regular expres- 
sion. If necessary the search wraps around to the end of the buffer. 


7. An address followed by a plus sign ‘+’ or a minus sign —’ followed by a decimal number specifies 
that address plus (resp. minus) the indicated number of lines. The plus sign may be omitted. 


8. An address followed by ‘+’ (or “—’) followed by a regular expression enclosed in slashes specifies 
the first matching line following (or preceding) that address. The search wraps around if neces- 
sary. The ‘+’ may be omitted, so ‘O/x/’ addresses the first line in the buffer with an ‘x’. Enclosing 
the regular expression in ‘?’ reverses the search direction. 


9. If an address begins with ‘+’ or ‘—’ the addition or subtraction is taken with respect to the current 
line; e.g. ‘—-5’ is understood to mean ‘.-5’. 


10. If an address ends with ‘+’ or ‘—’, then | is added (resp. subtracted). As a consequence of this rule 
and rule 9, the address ‘—’ refers to the line before the current line. Moreover, trailing ‘+’ and ‘“—’ 
characters have cumulative effect, so ‘—’ refers to the current line less 2. 

11. To maintain compatibility with earlier versions of the editor, the character ‘~ in addresses is 


equivalent to ‘—’. 


Commands may require zero, one, or two addresses. Commands which require no addresses regard the 
presence of an address as an error. Commands which accept one or two addresses assume default addresses 
when insufficient are given. If more addresses are given than such a command requires, the last one or two 
(depending on what is accepted) are used. 


Addresses are separated from each other typically by a comma ‘,’. They may also be separated by a semi- 
colon ‘;’. In this case the current line *.’ is set to the previous address before the next address is interpreted. 
If no address precedes a comma or semicolon, line | is assumed; if no address follows, the last line of the 
buffer is assumed. The second address of any two-address sequence must correspond to a line following 
the line corresponding to the first address. 


In the following list of ed commands, the default addresses are shown in parentheses. The parentheses are 
not part of the address, but are used to show that the given addresses are the default. 


As mentioned, it is generally illegal for more than one command to appear on a line. However, most com- 
mands may be suffixed by ‘p’ or by ‘I’, in which case the current line is either printed or listed respectively 
in the way discussed below. 


(.)a 
<text> 


. 


The append command reads the given text and appends it after the addressed line. ‘.’ is left on the 
last line input, if there were any, otherwise at the addressed line. Address ‘0’ is legal for this com- 
mand; text is placed at the beginning of the buffer. 
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(., .) b[+—][pagesize] [pln] 
The browse command provides page-oriented printing. The optional ‘+’ or “—’ specifies whether the 
next or previous page is to be printed; if absent, ‘+’ is assumed. If a pagesize is given, it is used for 
the current browse command and remembered as the default. The pagesize is initially 20 lines. if a 
terminal ‘p’ ‘n’, or ‘I’ is provided, the lines are printed in the specified format, and the format is 
remembered as the default. Initially, ‘p’ is the default. After a browse command, *.’ is left at the last 


line displayed. 
(.,.)c 


<text> 


The change command deletes the addressed lines, then accepts input text which replaces these lines. 
*.’ is left at the last line input; if there were none, it is left at the line preceding the deleted lines. 


(.,.)d 
The delete command deletes the addressed lines from the buffer. The line originally after the last line 
deleted becomes the current line; if the lines deleted were originally at the end, the new last line 
becomes the current line. 


e filename 
The edit command causes the entire contents of the buffer to be deleted, and then the named file to be 
read in. ‘.’ is set to the last line of the buffer. The number of characters read is typed. ‘filename’ is 
remembered for possible use as a default file name in a subsequent r or w command. If ‘filename’ is 


missing, the remembered name is used. 


E filename 
This command is the same as e, except that no diagnostic results when no w has been given since the 
last buffer alteration. 


f filename 
The filename command prints the currently remembered file name. If ‘filename’ is given, the cur- 
rently remembered file name is changed to ‘filename’. 


(1, $) g/regular expression/command list 

(1, $) g/regular expression/ 

(1, $) g/regular expression 
In the global command, the first step is to mark every line which matches the given regular expres- 
sion. Then for every such line, the given command list is executed with ‘.’ initially set to that line. A 
single command or the first of multiple commands appears on the same line with the global com- 
mand. All lines of a multi-line list except the last line must be ended with ‘\’. A, i, and c commands 
and associated input are permitted; the *.’ terminating input mode may be omitted if it would be on 
the last line of the command list. The commands g and v are not permitted in the command list. Any 
character other than space or newline may be used instead of ‘/’ to delimit the regular expression. 
The second and third forms mean ‘g/regular expression/p’. 


(.)i 


<text> 


This command inserts the given text before the addressed line. ‘.’ is left at the last line input, or, if 
there were none, at the line before the addressed line. This command differs from the a command 


only in the placement of the text. 


( 29. +1)j 
This command joins the addressed lines into a single line; intermediate newlines simply disappear. 
*. is left at the resulting line. 

(.) kx 
The mark command marks the addressed line with name x, which must be a lower-case letter. The 
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address form ‘’x’ then addresses this line. 


(.,-)1 
The list command prints the addressed lines in an unambiguous way: a tab is printed as ‘\t’, a back- 
space as ‘\b’, backslashes as ‘\’, a non-printing character is printed as a backslash followed by three 
octal digits, and a long line is folded, with the second and subsequent sub-lines indented one tab stop. 
If the last character in the line is a blank, it is followed by ‘\n’. The / command may be placed on the 
same line after any non-i/o command. 

(.,.)ma 
The move command repositions the addressed lines after the line addressed by a. The last of the 
moved lines becomes the current line. 

( ade a ) n 
This command is similar to the print command, but prefixes each line with its line number and a tab. 

( de Sh ) p 
The print command prints the addressed lines. *.’ is left at the last line printed. The p command 
may be placed on the same line after any non-i/o command. 

(.,.)P 
This command is a synonym for p. 

q The quit command causes ed to exit. No automatic write of a file is done. 

Q This command is the same as g, except that no diagnostic results when no w has been given since the 
last buffer alteration. 

($)r filename 


The read command reads in the given file after the addressed line. If no file name is given, the 
remembered file name, if any, is used (see e and f commands). The file name is remembered if there 
was no remembered file name already. Address ‘0’ is legal for r and causes the file to be read at the 
beginning of the buffer. If the read is successful, the number of characters read is typed. ‘.’ is left at 
the last line read in from the file. 


(.., .) sn/regular expression/replacement/ 
(..,.) sn/regular expression/replacement/g 
(.,.) sn/regular expression/replacement 


The substitute command searches each addressed line for an occurrence of the specified regular 
expression. On each line in which n matches are found (n defaults to 1 if missing), the nth matched 
string is replaced by the replacement specified. If the global replacement indicator ‘g’ appears after 
the command, all subsequent matches on the line are also replaced. It is an error for the substitution 
to fail on all addressed lines. Any character other than space or newline may be used instead of ‘/’ to 
delimit the regular expression and the replacement. *.’ is left at the last line substituted. The third 
form means ‘s/regular expression/replacement/p’; the replacement must not be empty. 


An ampersand ‘&’ appearing in the replacement is replaced by the string matching the regular 
expression. The characters ‘\n’ where n is a digit, are replaced by the text matched by the n-th regu- 
lar subexpression enclosed between ‘\( and ‘\)’. When nested, parenthesized subexpressions are pre- 
sent, n is determined by counting occurrences of ‘\(’ starting from the left. 


A literal ‘&’, ‘/’, ‘V or newline may be included in a replacement by prefixing it with ‘V. 


(.,.)ta 


This command acts just like the m command, except that a copy of the addressed lines is placed after 
address a (which may be 0). ‘.’ is left on the last line of the copy. 


(.,.)uU 


The undo command restores the preceding contents of the current line, which must be the last line in 
which a substitution was made. 
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(1, $) v/regular expression/command list 

(1, $) v/regular expression/ 

(1, $) v/regular expression 
This command is the same as the global command g except that the command list is executed g with 
‘. initially set to every line except those matching the regular expression. The second and third 
forms mean ‘v/regular expression/p’. 

(1, $) w filename 
The write command writes the addressed lines onto the given file. If the file does not exist, it is cre- 
ated mode 666 (readable and writable by everyone). The file name is remembered if there was no 
remembered file name already. If no file name is given, the remembered file name, if any, is used 
(see e and f commands). ‘.’ is unchanged. If the command is successful, the number of characters 
written is printed. 

(1, $)W filename 
This command is the same as w, except that the addressed lines are appended to the file. 

x A key string is demanded from the standard input. Later r, e and w commands will encrypt and 
decrypt the text with this key by the algorithm of crypt(1). An explicitly empty key turns off encryp- 
tion. 

($)= The line number of the addressed line is typed. ‘.’ is unchanged by this command. 

!<shell command> 
The remainder of the line after the ‘!’ is sent to sh(1) to be interpreted as a command. ‘.’ is 
unchanged. 

(.+1) <newline> 
An address or addresses alone on a line cause the addressed lines to be printed. A blank line alone is 
equivalent to ‘.+1p’; it is useful for stepping through text. 

If an interrupt signal (ASCII DEL) is sent, ed prints a ‘?’ and returns to its command level. 

Some size limitations: 512 characters per line, 256 characters per global command list, 127 characters per 

file name, and 128K characters in the temporary file. The limit on the number of lines depends on the 

amount of core: each line takes 1 word. 
When reading a file, ed discards ASCII NUL characters and all characters after the last newline. It refuses 
to read files containing non-ASCII characters. 
FILES 

/tmp/e* 

ed.hup: work is saved here if terminal hangs up 
SEE ALSO 

B. W. Kernighan, A Tutorial Introduction to the ED Text Editor 

B. W. Kernighan, Advanced editing on UNIX 

sed(1), crypt(1) 

DIAGNOSTICS 

“?name’ for inaccessible file; ‘?’ for errors in commands; ‘?TMP’ for temporary file overflow. 

To protect against throwing away valuable work, a g or e command is considered to be in error, unless a w 

has occurred since the last buffer change. A second g or e will be obeyed regardless. 

BUGS 
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NAME 

efl — extended Fortran language preprocessor 
SYNOPSIS 

efl [ option ... ] [ filename ... ] 
DESCRIPTION 


Efl compiles a program written in the EFL language into clean Fortran. Efl provides the same control flow 
constructs as does Ratfor (1), which are essentially identical to those in C: 


statement grouping with braces; 
decision-making with if, if-else, and switch-case; while, for, Fortran do, repeat, and repeat...until 
loops; multi-level break and next. In addition, EFL has C-like data structures, and more uniform 
and convenient input/output syntax, generic functions. EFL also provides some syntactic sugar to 
make programs easier to read and write: 


free form input: 
multiple statements/line; automatic continuation statement label names (not just numbers), 


comments: 
# this is a comment 


translation of relationals: 
>, >=, etc., become .GT., .GE., etc. 


return (expression) 
returns expression to caller from function 


define: define name replacement 
include: include filename 


The Efi command option —w suppresses warning messages. The option -C causes comments to be copied 
through to the Fortran output (default); -# prevents comments from being copied through. If a command 
argument contains an embedded equal sign, that argument is treated as if it had appeared in an option state- 
ment at the beginning of the program. Eff is best used with f77(1). 


SEE ALSO 
f77(1), ratfor(1). 
S. I. Feldman, The Programming Language EFL, Bell Labs Computing Science Technical Report #78. 
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delim $$ 


eqn, neqn, checkeq — typeset mathematics 


SYNOPSIS 


eqn [ -dxy ] [-pn ] [-sn ] [-fn ] [-Tdest ] [ file ] ... 
neqn [ option ] ... [ file ] ... 
checkeg [ file ] ... 


DESCRIPTION 
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Eqn is a troff(1) preprocessor for typesetting mathematics on a phototypesetter, negn on terminals. Usage 
is almost always 


eqn file ... | troff 
neqn file ... | nroff 


If no files are specified, these programs read from the standard input. Eqn prepares output for the typesetter 
named in the -T option (Mergenthaler Linotron 202 default, see troff(1)). 


A line beginning with ‘.EQ’ marks the start of an equation; the end of an equation is marked by a line 
beginning with ‘.EN’. Neither of these lines is altered, so they may be defined in macro packages to get 
centering, numbering, etc. It is also possible to set two characters as ‘delimiters’; subsequent text between 
delimiters is also treated as eqn input. Delimiters may be set to characters x and y with the command-line 
argument —dxy or (more commonly) with “delim xy’ between .EQ and .EN. The left and right delimiters 
may be identical. Delimiters are turned off by ‘delim off’. All text that is neither between delimiters nor 
between .EQ and .EN is passed through untouched. 


Checkeg reports missing or unbalanced delimiters and .EQ/.EN pairs. 


Tokens within egn are separated by spaces, tabs, newlines, braces, double quotes, tildes or circumflexes. 
Braces {} are used for grouping; generally speaking, anywhere a single character like x could appear, a 
complicated construction enclosed in braces may be used instead. Tilde ~ represents a full space in the out- 
put, circumflex * half as much, and tab represents an ordinary troff tab character. 


Subscripts and superscripts are produced with the keywords sub and sup. Thus x sub i makes $x sub i$, a 
sub i sup 2 produces $a sub i sup 2$, and e sup {x sup 2 + y sup 2} gives $e sup {x sup 2 + y sup 2}$. 


Fractions are made with over: a over b yields $a over b$. 
sqrt makes square roots: J over sqrt {ax sup 2 +bx+c} results in $1 over sqrt {ax sup 2 +bx+c}$ . 


The keywords from and to introduce lower and upper limits on arbitrary things: $lim from {n-> inf} sum 
from 0 to n x sub i$ is made with lim from {n—> inf } sum from 0 ton x sub i. 


Left and right brackets, braces, etc., of the right height are made with left and right: left [ x sup 2 + y sup 2 
over alpha right ] “="I1 produces $left [ x sup 2 + y sup 2 over alpha right ] ~="1$. The right clause is 
optional. Legal characters after left and right are braces, brackets, bars, ¢ and f for ceiling and floor, and "" 
for nothing at all (useful for a right-side-only bracket). 


Vertical piles of things are made with pile, Ipile, cpile, and rpile: pile {a above b above c} produces $pile 
{a above b above c}$. There can be an arbitrary number of elements in a pile. Ipile left-justifies, pile and 
cpile center, with different vertical spacing, and rpile right justifies. 


Matrices are made with matrix: matrix { Icol { x sub i above y sub 2 } ccol { 1 above 2 } } produces $matrix 
{ Icol { x sub i above y sub 2 } ccol { 1 above 2 } }$. In addition, there is rcol for a right-justified column. 


Diacritical marks are made with prime, dot, dotdot, hat, tilde, bar, under, vec, dyad, and under: x sub 0 
sup prime = f(t) bar + g(t) under is $x sub 0 sup prime = f(t) bar + g(t) under$, and x vec= y dyad is $x vec 
= y dyad$. 


Sizes and font can be changed with size n or size =n, roman, italic, bold, and font n. Size and fonts can be 
changed globally in a document by gsize n and gfont n, or by the command-line arguments —sn and —fn. 
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Normally subscripts and superscripts are reduced by 3 point sizes from the previous size; this may be 
changed by the command-line argument —pn. 


Successive display arguments can be lined up. Place mark before the desired lineup point in the first equa- 
tion; place lineup at the place that is to line up vertically in subsequent equations. 


Shorthands may be defined or existing keywords redefined with define: define thing % replacement % 
defines a new token called thing which will be replaced by replacement whenever it appears thereafter. The 
% may be any character that does not occur in replacement. 


Keywords like sum ( sum ) int ( int ) inf (inf ) and shorthands like >= (>=) —> (->), and != ( != ) are recog- 
nized. Greek letters are spelled out in the desired case, as in alpha or GAMMA. Mathematical words like 
sin, cos, log are made Roman automatically. Troff(1) four-character escapes like \(lh (<1) can be used any- 
where. Strings enclosed in double quotes "..."_ are passed through untouched; this permits keywords to be 
entered as text, and can be used to communicate with troff when all else fails. 

SEE ALSO 
troff(1), tbl(1), ms(7), eqnchar(7), doctype(1) 
B. W. Kernighan and L. L. Cherry, Typesetting Mathematics—User’s Guide 
J. F. Ossanna, NROFF/TROFF User’s Manual 


BUGS 
To embolden digits, parens, etc., it is necessary to quote them, as in “bold "12.3"”. 
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NAME 


expr — evaluate arguments as an expression 


SYNOPSIS 


expr arg... 


DESCRIPTION 


The arguments are taken as an expression. After evaluation, the result is written on the standard output. 
Each token of the expression is a separate argument. 


The operators and keywords are listed below. The list is in order of increasing precedence, with equal 
precedence operators grouped. 


expr | expr 
yields the first expr if it is neither null nor ‘0’, otherwise yields the second expr. 


expr & expr 
yields the first expr if neither expr is null or ‘0’, otherwise yields ‘0’. 


expr relop expr 
where relop is one of < <= = != >= >, yields ‘1’ if the indicated comparison is true, ‘0’ if false. 
The comparison is numeric if both expr are integers, otherwise lexicographic. 


expr + expr 
expr — expr 
addition or subtraction of the arguments. 


expr * expr 
expr / expr 
expr % expr 
multiplication, division, or remainder of the arguments. 


expr : expr 
The matching operator compares the string first argument with the regular expression second argu- 
ment; regular expression syntax is the same as that of ed(1). The \(...\) pattern symbols can be 
used to select a portion of the first argument. Otherwise, the matching operator yields the number 
of characters matched (‘0’ on failure). 


(expr ) parentheses for grouping. 


EXAMPLES 


a= expr $a + 1° 
Add 1 to shell variable a. 


expr $a: *.*/A(.*\)’ “|* $a 
Find the filename part (least significant part) of pathname a, which may or may not contain ‘/’. 
Note the quoted shell metacharacters. 


SEE ALSO 


DIAGNOSTICS 
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sh(1), test(1) 

Expr returns the following exit codes: 
0 if the expression is neither null nor ‘0’, 
1 if the expression is null or ‘0’, 
2 for invalid expressions. 
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NAME 

{77 — Fortran 77 compiler 
SYNOPSIS 

£77 [ option ] ... file ... 
DESCRIPTION 


F77 is a Fortran 77 compiler. It accepts several types of arguments: 


Arguments whose names end with ‘.f are taken to be Fortran 77 source programs; they are compiled, and 
each object program is left on the file in the current directory whose name is that of the source with ‘.o’ 
substituted for ’.f”. 


Arguments whose names end with ‘.r’ or ‘.e’ are taken to be Ratfor or EFL source programs, respectively; 
these are first transformed by the appropriate preprocessor, then compiled by f77. 


In the same way, arguments whose names end with ‘.c’ or ‘.s’ are taken to be C or assembly source pro- 
grams and are compiled or assembled, producing a ‘.o’ file. 


The following options have the same meaning as in cc(1). See /d(1) for load-time options. 


— Suppress loading and produce *.o’ files for each source file. 

-g Have the compiler produce additional symbol table information for sdb(1). Also pass the Ig flag 
to Id(1). 

-w Suppress all warning messages. If the option is ‘-w66’, only Fortran 66 compatibility warnings 


are suppressed. 
-p Prepare object files for profiling, see prof(1). 
-O Invoke an object-code optimizer. 


-S Compile the named programs, and leave the assembler-language output on corresponding files 
suffixed ‘.s’. (No ‘.o’ is created.). 


—0 output 
Name the final output file output instead of ‘a.out’. 


The following options are peculiar to f77. 


-onetrip Compile DO loops that are performed at least once if reached. (Fortran 77 DO loops are not per- 
formed at all if the upper limit is smaller than the lower limit.) 


-u Make the default type of a variable ‘undefined’ rather than using the default Fortran rules. 

-C Compile code to check that subscripts are within declared array bounds. 

-F Apply EFL and Ratfor preprocessors to relevant files, put the results in the files with the suffix 
changed to ‘.f’, but do not compile. 

—m Apply the M4 preprocessor to each ‘.r’ or ‘.e’ file before transforming it with the Ratfor or EFL 
preprocessor. 

-Ex Use the string x as an EFL option in processing ‘.e’ files. 

-Rx Use the string x as a Ratfor option in processing ‘.r’ files. 


Other arguments are taken to be either loader option arguments, or F77-compatible object programs, typi- 
cally produced by an earlier run, or perhaps libraries of F77-compatible routines. These programs, together 
with the results of any compilations specified, are loaded (in the order given) to produce an executable pro- 
gram with name ‘a.out’. 


FILES 
file.[fresc] input file 
file.o object file 
a.out loaded output 
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/usr/lib/f77pass1 compiler 

/ib/f1 pass 2 

Nib/c2 optional optimizer 
/usr/lib/ibF77.a intrinsic function library 
/usr/lib/libI77.a Fortran I/O library 
Nib/libc.a C library, see section 3 


SEE ALSO 
S. I. Feldman, P. J. Weinberger, A Portable Fortran 77 Compiler 
prof(1), cc(1), 1d(1), efl(1), ratfor(1) 
DIAGNOSTICS 
The diagnostics produced by f77 itself are intended to be self-explanatory. Occasional messages may be 
produced by the loader. 
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NAME 
factor, lfactor, qfactor, primes — factor a number, generate large primes 

SYNOPSIS 
factor [ number ] 
Ifactor 
qfactor 
primes [ start [ finish ] ] 

DESCRIPTION 
Factor prints number and its prime factors, each repated the proper number of times. The number must be 
positive and less than on (about 7.2x10'°). 
If no number is given, factor reads a stream of numbers from the standard input and factors them. It exits 
on any input not a positive integer. 
Maximum time to factor is proportional to Vn and occurs when n is prime or the square of a prime. 
Lfactor reads one number from the standard input and factors it. Worst-case running time is proportional to 
n-~; it beats factor for hard 12-digit problems and is workable to around n=10°. Qfactor reads one num- 
ber from the standard input and factors it. It is almost always better than /factor , and will factor numbers 
up to about 40 digits. 
Primes prints the prime numbers ranging from start to finish, where start and finish are positive numbers 
less than 2°°. If finish is missing, primes prints without end; if start is missing, it reads the starting number 
from the standard input. 

DIAGNOSTICS 
‘Ouch.’ for input out of range or for garbage input. 

BUGS 
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NAME 

file — determine file type 
SYNOPSIS 

file file ... 


file -f names 


DESCRIPTION 
File performs a series of tests on a set of files in an attempt to classify their contents by language or pur- 
pose. The names may be enumerated or contained in the file specified by the -foption. 


BUGS 
It can make mistakes, for example classifying a file of decimal data, ‘.01’, *.02’, etc. as troff(1) input. 


Page | 


FIND(1) Eighth Edition FIND(1) 


NAME 
find — find files 


SYNOPSIS 
find pathname-list expression 


DESCRIPTION 
Find recursively descends the directory hierarchy for each pathname in the pathname-list (i.e., one or more 
pathnames) seeking files that match a boolean expression written in the primaries given below. In the 
descriptions, the argument n is used as a decimal integer where +7 means more than n, —n means less than 
n and n means exactly n. 


—name filename 
True if the filename argument matches the current file name. Normal Shell argument syntax 
may be used if escaped (watch out for ‘[’, ‘?’ and ‘*’). 


—perm onum 
True if the file permission flags exactly match the octal number onum (see chmod(1)). If onum 
is prefixed by a minus sign, more flag bits (017777, see stat(2)) become significant and the 
flags are compared: (flags&onum)==onum. 


—type c True if the type of the file is c, where c is b, c, d, f or L for block special file, character special 
file, directory, plain file or symbolic link. 


-links n True if the file has n links. 


—user uname 
True if the file belongs to the user uname (login name or numeric user ID). 


—group gname 
True if the file belongs to group gname (group name or numeric group ID). 


-size n True if the file is n blocks long (512 bytes per block). 
-inumn_ ‘True if the file has inode number n. 

-atimen True if the file has been accessed in n days. 

-mtime n_ True if the file has been modified in n days. 


—exec command 
True if the executed command returns a zero value as exit status. The end of the command 
must be punctuated by an escaped semicolon. A command argument ‘{}’ is replaced by the 
current pathname. 


—ok command 
Like —-exec except that the generated command is written on the standard output, then the stan- 
dard input is read and the command executed only upon response y. 


—print Always true; causes the current pathname to be printed. 
—newer file True if the current file has been modified more recently than the argument file. 
The primaries may be combined using the following operators (in order of decreasing precedence): 


1) A parenthesized group of primaries and operators (parentheses are special to the Shell and must be 
escaped). 


2) The negation of a primary (‘!’ is the unary not operator). 
3) Concatenation of primaries (the and operation is implied by the juxtaposition of two primaries). 
4) Alternation of primaries (‘—o’ is the or operator). 


EXAMPLE 
To remove all files named ‘a.out’ or ‘*.o’ that have not been accessed for a week: 
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find / \(—name a.out —o —name ’*.0’ \) —atime +7 -exec rm {} \; 


FILES 
/etc/passwd 
/etc/group 


SEE ALSO 
sh(1), test(1), filsys(5) 


BUGS 
The syntax is painful. 
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NAME 
getuid, id — get user identity 
SYNOPSIS 
getuid [ - ] [ arguments ] 
id 
DESCRIPTION 
Getuid prints on its standard output information about its invoker, based on the effective user id, as pre- 


sented in the password file. With no arguments, getuid prints the login id of its invoker. Arguments select 
which information to print: 


user login id 

group group id 

passwd encrypted password 
uid numerical user id 

gid numerical group id 
acct GCOS account number 
bin GCOS output bin 
home home directory 

shell default shell 


If the optional - or more than one argument is present, the information is displayed in the form 
user=name 

as suitable for setting environment variables in the shell. 

Id prints the effective userid and groupid numerically, and, if possible, textually 


FILES 
/etc/passwd 
/etc/group 


SEE ALSO 
who(1), getuid(2), passwd(5), sh(1) 


BUGS 
Getuid reports the default group for the user, not the current effective group id. 
The login id reported is the first one in the password file with the correct numerical user id, not necessarily 
the login for the current session. 
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NAME 
grap — pic preprocessor for drawing graphs 


SYNOPSIS 
grap [ files ] 


DESCRIPTION 
Grap is a pic(1) preprocessor for drawing graphs on a typesetter. Graphs are surrounded by the troff ‘com- 
mands’ .G1 and .G2. Data that is enclosed is scaled and plotted, with tick marks supplied automatically. 
Commands exist to modify the frame, add labels, override the default ticks, change the plotting style, define 
coordinate ranges and transformations, and include data from files. In addition, grap provides the same 
loops, conditionals and macro processing that pic does. 


FILES 
/usr/lib/grap.defines: definitions of standard plotting characters, e.g., bullet. 


SEE ALSO 


graph(1), plot(3) 
J. L. Bentley, B. W. Kernighan, GRAP — A Language for Typesetting Graphs 
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graph — draw a graph 


SYNOPSIS 
graph [ option ] ... 


spline [ option ] ... 
DESCRIPTION 
Graph with no options takes pairs of numbers from the standard input as abscissas (x-values) and ordinates 
(y-values) of a graph. Successive points are connected by straight lines. The graph is encoded on the stan- 
dard output for display by the plot(1) filters. 


If the ordinate of a point is followed by a nonnumeric string, that string is printed as a label beginning on 
the point. Labels may be surrounded with quotes "...", in which case they may be empty or contain blanks 
and numbers; labels never contain newlines. 


The following options are recognized, each as a separate argument. 


—a 


—m 


-0 


-S 
-x [1] 


-y[1] 
-—e 

-h 

—-W 

-r 

—u 


-t 


Supply abscissas automatically; no x-values appear in the input. Spacing is given by the next 
argument (default 1). A second optional argument is the starting point for automatic abscissas 
(default 0, or 1 with a log scale in x, or the lower limit given by —x). 


Break (disconnect) the graph after each label in the input. 
Character string given by next argument is default label for each point. 
Next argument is grid style, 0 no grid, | frame with ticks, 2 full grid (default). 


Next argument is a legend to title the graph. Grid ranges are automatically printed as part of the 
title unless a -s option is present. 


Next argument is mode (style) of connecting lines: 0 disconnected, 1 connected. Some devices 
give distinguishable line styles for other small integers. Mode —1 (default) begins with style 1| 
amd rotates styles for successive curves under option -0. 


(Overlay.) The ordinates for n superposed curves appear in the input with each abscissa value. 
The next argument is 7. 


Save screen; no new page for this graph. 


If lis present, x axis is logarithmic. Next 1 (or 2) arguments are lower (and upper) x limits. Third 
argument, if present, is grid spacing on x axis. Normally these quantities are determined automati- 
cally. 


Similarly for y. 

Make automatically determined x and y scales equal. 

Next argument is fraction of space for height. 

Similarly for width. 

Next argument is fraction of space to move right before plotting. 
Similarly to move up before plotting. 


Transpose horizontal and vertical axes. (Option —a now applies to the vertical axis.) 


If a specified lower limit exceeds the upper limit, the axis is reversed. 


Spline is a filter that interpolates extra data in input suitable for graph to make smoother-looking curves. 


The following options are recognized, each as a separate argument. 


—a 


-x 


as in graph 
as in graph 
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-k The constant k used in the boundary value computation 


y sub 0 sup {prime prime}"="ky sub | sup {prime prime} , ~~ y sub n sup {prime prime}"=ky sub 
n-1 sup {prime prime} , ~~ 


is set by the next argument. (Default k = 0.) 


—n Space output points so that approximately n intervals occur between the lower and upper x limits. 
(Default n = 100.) 


-p Make output periodic, i.e. match derivatives at ends. First and last input values should normally 
agree. 


DIAGNOSTICS 


When data is not strictly monotone in x, spline simply reproduces its input. 


SEE ALSO 


BUGS 


plot(1), grap(1) 


In graph segments that run out of bounds are dropped, not windowed. 

Logarithmic axes may not be reversed. 

Option —e actually makes automatic limits, rather than automatic scaling, equal. 

Spline quietly discards points after the first 1000. 

Spline’s piecewise cubic fit (R. W. Hamming, Numerical Methods for Scientists and Engineers, 2nd ed., p. 
349) overshoots at sudden jumps. 
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NAME 
grep, egrep, fgrep — search a file for a pattern 


SYNOPSIS 
grep [ options ] expression [ files ] 


egrep [ options ] [ expression ] [ files ] 
fgrep [ options ] [ strings ] [ files ] 


DESCRIPTION 
Commands of the grep family search the input files (standard input default) for lines matching a pattern. 
Normally, each line found is copied to the standard output. Grep patterns are limited regular expressions in 
the style of ed(1); it uses a compact non-deterministic algorithm. Egrep patterns are full regular 
expressions; it uses a fast deterministic algorithm. F grep patterns are fixed strings; it is fast and compact. 
The following options are recognized: 


-v All lines but those matching are printed. 

-x (Exact) only lines matched in their entirety are printed (fgrep only). 

-c Only a count of matching lines is printed. 

-i Ignore alphabetic case distinctions. 

-l Only the names of files with matching lines are listed (once), separated by new-lines. 

—n Each line is preceded by its relative line number in the file. 

-b Each line is preceded by the block number on which it was found. This is sometimes useful in 
locating disk block numbers by context. 

-h Do not print filename headers with output lines. 

-s No output is produced, only status. 


—e expression 
Same as a simple expression argument, but useful when the expression begins with a -. 
-ffile The regular expression (egrep) or strings list (fgrep) is taken from the file. 


Output lines are tagged by filename when there is more than one input file. Care should be taken when 

using the shell metacharacters $* [7] O\ in expression; it is safest to enclose the entire expression in single 
, , 

quotes ’... 


F grep searches for lines that contain one of the strings separated by new-lines. 


Egrep accepts regular expressions as in ed(1), except for \(, \), and \n, with the addition of: 


1. A regular expression followed by + matches one or more occurrences of the expression. 

2. A regular expression followed by ? matches 0 or | occurrence. 

3: Two regular expressions separated by | or newline match ocurrences of either. 

4. Parentheses () specify grouping. 

The order of precedence of operators is [], then * ? +, then concatenation, then | and new-line. 
SEE ALSO 

ed(1), sed(1), sh(1). 
DIAGNOSTICS 


Exit status is 0 if any matches are found, | if none, 2 for syntax errors or inaccessible files (even if matches 
were found). 


BUGS 
Ideally there should be only one grep, but we do not know a single algorithm that spans a wide enough 
range of space-time tradeoffs. 
Lines are truncated at BUFSIZ characters; see setbuf(3). Null characters behave as end-of-line in matches. 
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NAME 
hang — start a process in stopped state 


SYNOPSIS 
hang command 


DESCRIPTION 
The given command is executed, but stopped before main() is called so that the process can be picked up by 
a debugger. To ensure that breakpoints may be set, the process does not share its text. 


SEE ALSO 
pi(9.1), kill(1) 


Page | 


HOC(1) 


Eighth Edition HOC(1) 


NAME 
hoc — interactive floating point language 
SYNOPSIS 
hoc [ file ... ] 
DESCRIPTION 
Hoc interprets a simple language for floating point arithmetic, at about the level of BASIC, with C-like syn- 
tax and functions. 
The named files are read and interpreted in order. If no file is given or if file is —’ hoc interprets the stan- 
dard input. 
Hoc input consists of expressions and statements. Expressions are evaluated and their results printed. 
Statements, typically assignments and function or procedure definitions, produce no output unless they 
explicitly call print. 
Variable names are the usual syntax, including *_’; the name ‘ ’ by itself contains the value of the last 
expression evaluated. The variables E, PI, PHI, GAMMA and DEG are predefined; the last is 59.25..., 
degrees per radian. 
Expressions are formed with these operators: 
. exponentiation 
!-+4+— unary logical and arithmetic negation, ... 
* | % the obvious 
+- ditto 
>>e<<eaa!= 
&E& 
I 
= 4s —= t= /= S= 
Built in functions include abs, atan (one argument), cos, exp, int, log, log10, sin, and sqrt. The function 
read(x) reads a value into the variable x; the statement print prints a list of expressions that may include 
string constants such as hello\n.” 
Control flow includes if-else, while, and for, with braces for grouping. End of line marks end of statement, 
as does a semicolon. 
Functions and procedures are introduced by the words func and proc; return is used to return, with a value 
from a function. Within a function or procedure, arguments are referred to as $7, $2, etc.; all other vari- 
ables are global. 
SEE ALSO 
The Unix Programming Environment by Brian Kernighan and Rob Pike. 
be(1), de(1) 
BUGS 
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Error recovery is imperfect within function and procedure definitions. 
The treatment of newlines is not exactly user-friendly. 
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NAME 

icont, iconc — Icon language translator and compiler 
SYNOPSIS 

icont [ option ... ] file ... [-x arg ... ] 

iconc [ option ... ] file ... 
DESCRIPTION 


FILES 
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Icont translates Version 5 of the Icon programming language to an intermediate form, and link edits inter- 
mediate files to interpretable files. conc does the same, but finally compiles to machine code. Unless the 
—0 option is specified, the name of the linked file is formed by deleting the suffix of the first input file 
named on the command line. Option —x invokes the interpreter and passes the args to the Icon program. 


Files whose names end in ‘.icn’ are assumed to be Icon source programs; files whose names end in ‘.ul’ or 
“u2’ are assumed to be intermediate files from a previous translation (only one should be named — the 
other is assumed). Unnamed .ul and .u2 files are deleted. The argument — signifies the use of standard 
input as a source file. 


The following options are recognized by icont. 


—c Suppress linking and loading; preserve intermediate files. 
—m Preprocess each ‘.icn’ source file with the m4(1) macro processor before translation. 
—0 output 
Name the interpretable file output. 
-s Suppress informative messages. 
-t Arrange for &trace to have an initial value of —1 instead of 0 when the program is executed. 
-u Issue warning messages for undeclared identifiers. 


To run either and interpreatable or an executable file, simply execute it as a command. The following envi- 
ronment variables — all numeric — affect execution: 


TRACE Initialize the value of &trace, overriding the translation option -t. 


NBUFS The number of i/o buffers to use for files, normally 3. &input and &output are buffered unless 
they are terminals. &errout is never buffered. 


STRSIZE 
The initial size of the string space, in bytes, normally 51200. 


HEAPSIZE 
The initial size of the heap, in bytes, normally 51200. 


NSTACKS 
The number of stacks initially available for co-expressions, normally 4. 


STKSIZE 
The size of each co-expression stack, in words, normally, 2000. 


PROFILE 
Turn on execution profiling of the runtime system. The value of this variable specifies the sam- 
pling resolution, in words. If the value is zero, profiling is not done. The profiling results are left 
in a file ‘mon.out’ for interpretation by prof(1). 


v5v/int/bin/utran icon translator 
v5v/int/bin/ulink — icon linker 
v5v/emp/bin/libi.a icon runtime library 
v5v/int/bin/iconx icon interpreter 
mon.out results of profiling 
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* ul, *.u2 intermediate files 


SEE ALSO 


BUGS 


Reference Manual for the Icon Programming Language, Version 5, Technical Report TR 81—4a, Depart- 
ment of Computer Science, The University of Arizona, Tucson, Arizona, December 1981. 

Co-Expressions in Icon, Technical Report TR 82-4, Department of Computer Science, The University of 
Arizona. 

iconc(1), m4(1), prof(1), exec(2), monitor(3) 


If the -m option is used, line numbers reported in error messages or tracing messages are from the file after, 
not before, preprocessing. 

Integer overflow on multiplication is not detected. 

An interpretable file produced on one system will not work on another system unless the Icon interpreter is 
in the same place on both systems. 

Because of the way that co-expressions are implemented, there is a possibility that programs in which they 
are used may malfunction mysteriously. 
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NAME 
ideal — troff preprocessor for drawing pictures 
SYNOPSIS 
ideal [ -p ] [-4] [-n ] [ files ] 
DESCRIPTION 
Ideal is yet another troff(1) preprocessor for drawing figures on a typesetter. A line beginning ‘.IS’ marks 
the start of an ideal program. An ideal program ends with ‘.IE’ or ‘.IF’; ‘.IE’ leaves you below the bottom 
of the picture, while ‘.IF’ (flyback) leaves you at the same place you were when you said ‘.IS’. 
When invoked with the —p option, ideal produces plot(1) instructions. The erases come at every ‘.IS’, and 
they come fast and furious, so you might prefer using the —-4 option, which produces instructions for a Tek- 
tronix 4014, and waits at each ‘.IE’ for an input character before erasing and starting the next picture. The 
—n option produces raw ideal output, which passes unharmed through nroff. 
The building block for ideal programs is a ““box’’; boxes look like C functions, in that they are named, and 
delimited by braces. They may include the following kinds of statements, each terminated by a semicolon: 
var declares one or more complex variables local to the box. Variable names are made up of letters 
and digits, and start with a letter; do not use any of the following keywords as variable names: at, 
bdlist, boundary, box, conn, construct, draw, exterior, interior, left, opaque, put, right, spline, text, 
to, using, var 
equation 
declares relative positions of significant points of the box 
conn asks for a straight-line path through named points 
pen asks for a box to be replicated along a line between two points 
left left-justifies text with respect to a point 
text centers text with respect to a point 
right _ right-justifies text with respect to a point 
spline draws a spline guided by the named points 
put asks for an instance of a box to be drawn 
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opaque asks for a box to erase lines already in the picture that are covered by its bounding polygon 


boundary 
specifies the bounding polygon for an opaque box 


construct 
builds a partial picture on a separate ‘‘sheet of paper’’ 


draw adds the contents of the named constructed box to the current picture 


Ideal expects all components of a picture to be specified as boxes; instructions to draw the entire picture 
should comprise a box called ‘‘main.’’ Boxes are remembered across .IS-.IE boundaries; if you won’t need 
a box again, you can reclaim the space it requires by including the command “...forget boxname’ on a line 
between any .IS-.IE pair after the last use of boxname. Box main is an exception to this rule: it is always 
forgotten when the .IE is processed. 


During its first pass, ideal solves all the equations to determine the locations of all points it needs to know. 
These equations must be linear equations in complex variables, although they may include non-linear oper- 
ators: ideal plugs in for as many variables, and does as much function evaluation, as it can before solving 
the linear equation. It waits until it has absolutely no hope of reducing an equation to a linear equation 
before complaining. [deal knows about the following functions: 


afz,w] $=="z+ alpha (w-z)$, $alpha$ of the way from $z$ to $w$ 
re(z) real part of complex number 

im(z) imaginary part of complex number 

conj(z) complex conjugate of complex number 


abs(z) absolute value (modulus) of complex number 
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cis(x) a unit vector in the direction of the real part of its argument, which is an angle in degrees (radians 
if the line ‘...radians’ appeared more recently in the file than the line *...degrees’) 


E(x) $=="cis (360x)$ if $x$ is measured in degrees 


angle(z) 
angle of complex number, arctan $(im(z)/re(z))$ 


During the second pass, ideal draws the picture. 


‘ 


To draw a circle, include the line ‘...libfile circle’ between the IS and JE lines, and put the box named 
circle, giving enough information that the circle can be determined; for instance, give the center and the 
radius, or give three points through which the circle passes, or give the center and a point on the circle. The 
circle has center center, radius radius, and passes through z/, z2, and z3. 


‘ 


To draw an arc, include the line ‘...libfile arc’ between the .IS and .IE lines, and put the box named arc, 
again giving enough information to determine the arc; for instance, give the center, radius, and starting and 
ending angles, or give three points on the arc--where to start, where to end, and somewhere in between. 
The arc has center center, radius radius, starts at point start, passes through point midway at angle midang, 
and ends at point end at angle endang. If no midway is specified, the arc is drawn counterclockwise from 
Start to end. 


The picture will be scaled to a default width of four inches and centered in a column of six inches. The 
default width can be changed by a ‘...width’ command, which includes a number in inches. The default 
column width can be changed by a ‘...colwid’ command. To defeat ideal’s notion of the size of the picture, 
you can include lines of the form ‘...minx’, ‘...miny’, ‘...maxx’, or ‘...maxy’; these give the various coordi- 
nates of the bounding box of the picture in the coordinate system used by the picture. 


Ideal supports both C-style comments (between /* and */ brackets, and they nest), and shell-style comments 
(between # and newline). 


SEE ALSO 
C. J. Van Wyk, IDEAL User’s Manual , C. J. Van Wyk. 
pic(1), ped(9.1), doctype(1) 

BUGS 


Ideal is relatively unforgiving about syntax errors. Bounding box computation is naive for arcs and text 
strings. 
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NAME 
idiff — interactive file comparison 


SYNOPSIS 
idiff file1 file2 


DESCRIPTION 
Idiff compares file] with file2 using diff, then presents each set of changed lines for selection or processing. 
File2 may be a directory; in that case, the basename of file/ is appended. 


For each group, legal responses are 
< to retain the ‘from’ lines 
> to retain the ‘to’ lines 

to edit both sets of lines 
to delete both sets 


to retain the rest of the ‘from’ file 


No FS Aa Oo 


to retain the rest of the ‘to’ file 
! to invoke a shell command 


Lines common to each file are copied verbatim. Lines produced by this process, including the lines written 
from within the editor, are written to file idiff-out. 


FILES 
idiff.out 
idiff.* 
/tmp/idiff.* 
SEE ALSO 
diff(1), diff3(1) 
BUGS 
There is no way to revisit a choice. 
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NAME 
iostat, load, dkstat — report I/O and CPU statistics 


SYNOPSIS 
iostat [ interval [ count ] ] 


load [ interval [ count [ sysfile [ corefile ] ] ] ] 
dkstat [ interval [ count ] ] 


DESCRIPTION 
Tostat periodically reports the number of characters read and written to terminals, and, for each disk, the 
number of seeks and transfers per second, and average milliseconds per seek. It also reports the percentage 
of time the system has spent in user mode, in user mode running low priority (niced) processes, in system 
mode, and idling. The first report is for all time since a reboot and each subsequent report is for the last 
interval only. 


Load periodically reports the number of processes ready to run averaged over the preceding 1, 5, and 15 
minutes. 


Dkstat periodically reports the number of packets received and sent over the Datakit network, together with 
error reports if any occurred. The first report is for all time since a reboot and each subsequent report is for 
the last interval only. 


The optional interval argument causes a report once each interval seconds. 
The optional count argument restricts the number of reports. 


The optional arguments sysfile and corefile cause the named files to be consulted instead of the defaults, 
‘/unix’ and ‘/dev/kmem’. 


FILES 
/dev/kmem 
/unix 

SEE ALSO 


sysmon(9.1), vmstat(8) 
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join — relational database operator 


SYNOPSIS 


DESCRI 


join [ options ] file! file2 


PTION 
Join forms, on the standard output, a join of the two relations specified by the lines of file/ and file2. If 
filel is ‘—’, the standard input is used. 


File and file2 must be sorted in increasing ASCII collating sequence on the fields on which they are to be 
joined, normally the first in each line. 


There is one line in the output for each pair of lines in file/ and file2 that have identical join fields. The out- 
put line normally consists of the common field, then the rest of the line from file/, then the rest of the line 
from file2. 


Fields are normally separated by blank, tab or newline. In this case, multiple separators count as one, and 
leading separators are discarded. 


These options are recognized: 

—an In addition to the normal output, produce a line for each unpairable line in file n, where n is | or 2. 
es Replace empty output fields by string s. 

-jnm Join on the mth field of filen. If n is missing, use the mth field in each file. 


-o list Each output line comprises the fields specifed in /ist, each element of which is O or has the form 
n.m, where n is a file number and m is a field number. 0 designates the join field. 


-tc Use character c as a separator (tab character). Every appearance of c in a line is significant. 


SEE ALSO 


BUGS 
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sort(1), comm(1), awk(1) 


With default field separation, the collating sequence is that of sort—b; with -t, the sequence is that of a 
plain sort. 
The conventions of join, sort, comm, unig, look and awk(1) are wildly incongruent. 
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NAME 
kill — terminate a process with extreme prejudice 


SYNOPSIS 
kill [ -sig ] processid ... 
kill 4 


DESCRIPTION 
Kill sends the TERM (terminate, 15) signal to the specified processes. If a signal name or number preceded 
by ‘—’ is given as first argument, that signal is sent instead of terminate (see signal(2)). The signal names 
are listed by ‘kill -l’, and are as given in /media/acher/Games/v8/usr/include/signal.h, stripped of the com- 
mon SIG prefix. 


The terminate signal will kill processes that do not catch the signal; ‘kill —-9 ...” is a sure kill, as the KILL 
signal (signal 9) cannot be caught. By convention, if process number 0 is specified, all members in the pro- 
cess group (i.e. processes resulting from the current login) are signaled. The killed processes must belong 
to the current user unless he is the super-user. 


To shut the system down and bring it up single user the super-user may send the initialization process a 
TERM (terminate) signal by ‘kill 1’; see init(8). To force init to close and open terminals according to 
what is currently in /etc/ttys use ‘kill —1 1’ (sending a hangup, signal 1). 


The process number of an asynchronous process started with “&’ is reported by the shell and by ps(1). 


SEE ALSO 
ps(1), kill(2), signal(2) 


Page | 


SH(1) 


Eighth Edition SH(1) 


NAME 
ksh — Korn shell, the not standard command programming language 
SYNOPSIS 
ksh [ -acefhikmnorstuvx ] [-o option]... [arg ... ] 
DESCRIPTION 
Ksh is acommand programming language that executes commands read from a terminal or a file. Rsh is a 
restricted version of the standard command interpreter sh; it is used to set up login names and execution 
environments whose capabilities are more controlled than those of the standard shell. See Invocation 
below for the meaning of arguments to the shell. 
Definitions. 
A metacharacter is one of the following characters: 
; & () | < > new-line space tab 
A blank is a tab or a space. An identifier is a sequence of letters, digits, or underscores starting with a let- 
ter or underscore. Identifiers are used as names for aliases, functions, and named parameters. A word isa 
sequence of characters separated by one or more non-quoted metacharacters. 
Commands. 
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A simple-command is a sequence of blank separated words which may be preceded by a parameter assign- 
ment list. (See Environment below). The first word specifies the name of the command to be executed. 
Except as specified below, the remaining words are passed as arguments to the invoked command. The 
command name is passed as argument 0 (see exec(2)). The value of a simple-command is its exit status if 
it terminates normally, or (octal) 200+status if it terminates abnormally (see signal(2) for a list of status 
values). 


A pipeline is a sequence of one or more commands separated by |. The standard output of each command 
but the last is connected by a pipe(2) to the standard input of the next command. Each command is run as a 
separate process; the shell waits for the last command to terminate. The exit status of a pipeline is the exit 
status of the last command. 


A list is a sequence of one or more pipelines separated by 5, &, &&, or | |, and optionally terminated by ;, 
&, or | &. Of these five symbols, ;, &, and | & have equal precedence, which is lower than that of && and 
| |. The symbols && and | | also have equal precedence. A semicolon (;) causes sequential execution of 
the preceding pipeline; an ampersand (&) causes asynchronous execution of the preceding pipeline (i.e., the 
shell does not wait for that pipeline to finish). The symbol | & causes asynchronous execution of the pre- 
ceding command or pipeline with a two-way pipe established to the parent shell. The standard input and 
output of the spawned command can be written to and read from by the parent Shell using the —p option of 
the special commands read and print described later. Only one such command can be active at any given 
time. The symbol && ( | |) causes the list following it to be executed only if the preceding pipeline 
returns a zero (non-zero) value. An arbitrary number of new-lines may appear in a /ist, instead of semi- 
colons, to delimit commands. 


A command is either a simple-command or one of the following. Unless otherwise stated, the value 
returned by a command is that of the last simple-command executed in the command. 


for identifier [ in word ... | do list done 
Each time a for command is executed, identifier is set to the next word taken from the in word 
list. Ifin word ... is omitted, then the for command executes the do list once for each positional 
parameter that is set (see Parameter Substitution below). Execution ends when there are no more 
words in the list. 


select identifier [ in word ... | do list done 
A select command prints on standard error (file descriptor 2), the set of words, each preceded by a 
number. If in word ... is omitted, then the positional parameters are used instead (see Parameter 
Substitution below). The PS3 prompt is printed and a line is read from the standard input. If this 
line consists of the number of one of the listed words, then the value of the parameter identifier is 
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set to the word corresponding to this number. If this line is empty the selection list is printed 
again. Otherwise the value of the parameter identifier is set to null. The contents of the line read 
from standard input is saved in the parameter REPLY. The Jist is executed for each selection until 
a break or end-of-file is encountered. 


case word in [ pattern [ | pattern |...) list 33 ]... esac 
A case command executes the list associated with the first pattern that matches word. The form 
of the patterns is the same as that used for file-name generation (see File Name Generation 
below). 


if list then list [ elif list then list ]...[ else list ] fi 
The list following if is executed and, if it returns a zero exit status, the Jist following the first then 
is executed. Otherwise, the list following elif is executed and, if its value is zero, the list follow- 
ing the next then is executed. Failing that, the else list is executed. If no else /ist or then ist is 
executed, then the if command returns a zero exit status. 


while list do list done 

until Jist do list done 
A while command repeatedly executes the while Jist and, if the exit status of the last command in 
the list is zero, executes the do /ist; otherwise the loop terminates. If no commands in the do Jist 
are executed, then the while command returns a zero exit status; until may be used in place of 
while to negate the loop termination test. 


(list) 
Execute list in a separate environment. Note, that if two adjacent open parentheses are needed for 
nesting, a space must be inserted to avoid arithmetic evaluation as described below. 
{ lists} 
list is simply executed. Note that { is a keyword and requires a blank in order to be recognized. 
function identifier { list 3} 
identifier () { list 3} 
Define a function which is referenced by identifier. The body of the function is the list of com- 
mands between { and }. (See Functions below). 
time pipeline 
The pipeline is executed and the elapsed time as well as the user and system time are printed on 
standard error. 
The following keywords are only recognized as the first word of a command and when not quoted: 


if then else elif fi case esac for while until do done { } function select time 


Comments. 


A word beginning with # causes that word and all the following characters up to a new-line to be ignored. 


Aliasing. 


The first word of each command is replaced by the text of an alias if an alias for this word has been 
defined. The first character of an alias name can be any printable character, but the rest of the characters 
must be the same as for a valid identifier. The replacement string can contain any valid Shell script includ- 
ing the metacharacters listed above. The first word of each command of the replaced text will not be tested 
for additional aliases. If the last character of the alias value is a blank then the word following the alias will 
also be checked for alias substitution. Aliases can be used to redefine special builtin commands but cannot 
be used to redefine the keywords listed above. Aliases can be created, listed, and exported with the alias 
command and can be removed with the unalias command. Exported aliases remain in effect for sub-shells 
but must be reinitialized for separate invocations of the Shell (See Invocation below). 


Aliasing is performed when scripts are read, not while they are executed. Therefore, for an alias to take 
effect the alias command has to be executed before the command which references the alias is read. 
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Aliases are frequently used as a short hand for full path names. An option to the aliasing facility allows the 
value of the alias to be automatically set to the full pathname of the corresponding command. These aliases 
are called tracked aliases. The value of a tracked alias is defined the first time the identifier is read and 
becomes undefined each time the PATH variable is reset. These aliases remain tracked so that the next sub- 
sequent reference will redefine the value. Several tracked aliases are compiled into the shell. The —h 
option of the set command makes each command name which is an identifier into a tracked alias. 


The following exported aliases are compiled into the shell but can be unset or redefined: 
echo=’print —’ 
false=let 0’ 
functions=’typeset —f 
history=fe -l’ 
integer='typeset —i’ 
nohup=‘nohup ’ 
pwd=’print — $PWD’ 
r="fe -e — 
true=’:’ 
type=’ whence —v’ 
hash=“alias —t’ 


Tilde Substitution. 


After alias substitution is performed, each word is checked to see if it begins with an unquoted ~. If it does, 
then the word up to a / is checked to see if it matches a user name in the /etc/passwd file. If a match is 
found, the ~ and the matched login name is replaced by the login directory of the matched user. This is 
called a tilde substitution. If no match is found, the original text is left unchanged. A ~ by itself, or in front 
of a /, is replaced by the value of the HOME parameter. A ~ followed by a + or — is replaced by the value 
of the parameter PWD and OLDPWD respectively. 


In addition, the value of each keyword parameter is checked to see if it begins with a ~ or if a ~ appears 
after a:. In either of these cases a tilde substitution is attempted. 


Command Substitution. 


The standard output from a command enclosed in a pair of grave accents (~~) may be used as part or all of 
a word; trailing new-lines are removed. The command substitution * cat files can be replaced by the equiv- 
alent but faster *<files. Command substitution of most special commands that do not perform input/output 
redirection are carried out without creating a separate process. 


Parameter Substitution. 
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A parameter is an identifier, a digit, or any of the characters *, @, #, ?, -,$, and !. A named parameter (a 
parameter denoted by an identifier) has a value and zero or more attributes. Named parameters can be 
assigned values and attributes by using the typeset special command. The attributes supported by the 
Shell are described later with the typeset special command. Exported parameters pass values and attributes 
to sub-shells but only values to the environment. 


The shell supports a limited one-dimensional array facility. An element of an array parameter is referenced 
by a subscript. A subscript is denoted by a [, followed by an arithmetic expression (see Arithmetic evalua- 
tion below) followed by a ]. The value of all subscripts must be in the range of 0 through 511. Arrays need 
not be declared. Any reference to a named parameter with a valid subscript is legal and an array will be 
created if necessary. Referencing an array without a subscript is equivalent to referencing the first element. 


The value of a named parameter may also be assigned by writing: 
name=value [| name=value |... 


If the integer attribute, —i, is set for name the value is subject to arithmetic evaluation as described below. 
Positional parameters, parameters denoted by a number, may be assigned values with the set special com- 
mand. Parameter $0 is set from argument zero when the shell is invoked. 

The character $ is used to introduce substitutable parameters. 
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${parameter} 
The value, if any, of the parameter is substituted. The braces are required when parameter is fol- 
lowed by a letter, digit, or underscore that is not to be interpreted as part of its name or when a 
named parameter is subscripted. If parameter is a digit then it is a positional parameter. If 
parameter is * or @, then all the positional parameters, starting with $1, are substituted (separated 
by spaces). If an array identifier with subscript * or @ is used, then the value for each of the ele- 
ments is substituted (separated by spaces). 

${#parameter} 
If parameter is not *, the length of the value of the parameter is substituted. Otherwise, the num- 
ber of positional parameters is substituted. 

${#identifier[*]} 
The number of elements in the array identifier is substituted. 

${parameter:—word} 
If parameter is set and is non-null then substitute its value; otherwise substitute word. 

${parameter:=word} 
If parameter is not set or is null then set it to word; the value of the parameter is then substituted. 
Positional parameters may not be assigned to in this way. 

${parameter:?word} 
If parameter is set and is non-null then substitute its value; otherwise, print word and exit from 
the shell. If word is omitted then a standard message is printed. 

${parameter:+word} 
If parameter is set and is non-null then substitute word; otherwise substitute nothing. 

${parameter#pattern} 

${parameter##pattern } 
If the Shell pattern matches the beginning of the value of parameter, then the value of this substi- 
tution is the value of the parameter with the matched portion deleted; otherwise the value of this 
parameter is substituted. In the first form the smallest matching pattern is deleted and in the latter 
form the largest matching pattern is deleted. 


${parameter % pattern } 

${parameter % % pattern} 
If the Shell pattern matches the end of the value of parameter, then the value of parameter with 
the matched part deleted; otherwise substitute the value of parameter. In the first form the small- 
est matching pattern is deleted and in the latter form the largest matching pattern is deleted. 


In the above, word is not evaluated unless it is to be used as the substituted string, so that, in the following 
example, pwd is executed only if d is not set or is null: 


echo ${d:—* pwd* } 


If the colon ( : ) is omitted from the above expressions, then the shell only checks whether parameter is set 
or not. 


The following parameters are automatically set by the shell: 
# The number of positional parameters in decimal. 
- Flags supplied to the shell on invocation or by the set command. 
? The decimal value returned by the last executed command. 
$ The process number of this shell. 
The last argument of the previous command. This parameter is not set for commands 
which are asynchronous. 
The process number of the last background command invoked. 
PPID The process number of the parent of the shell. 
PWD _ The present working directory set by the cd command. 
OLDPWD 
The previous working directory set by the cd command. 


_ 
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RANDOM 
Each time this parameter is referenced, a random integer is generated. The sequence of 
random numbers can be initialized by assigning a numeric value to RANDOM. 

REPLY This parameter is set by the select statement and by the read special command when no 
arguments are supplied. 


The following parameters are used by the shell: 


CDPATH 
The search path for the cd command. 

COLUMNS 
If this variable is set, the value is used to define the width of the edit window for the shell 
edit modes and for printing select lists. 

EDITOR 
If the value of this variable ends in emacs, gmacs, or vi and the VISUAL variable is not 
set, then the corresponding option (see Special Command set below) will be turned on. 

ENV _ If this parameter is set, then parameter substitution is performed on the value to generate 
the pathname of the script that will be executed when the shell is invoked. (See 
Invocation below.) This file is typically used for alias and function definitions. 

FCEDIT 
The default editor name for the fe command. 

IFS Internal field separators, normally space, tab, and new-line that is used to separate com- 
mand words which result from command or parameter substitution and for separating 
words with the special command read. 

HISTFILE 
If this parameter is set when the shell is invoked, then the value is the pathname of the 
file that will be used to store the command history. (See Command re-entry below.) 

HISTSIZE 
If this parameter is set when the shell is invoked, then the number of previously entered 
commands that are accessible by this shell will be greater than or equal to this number. 
The default is 128. 

HOME The default argument (home directory) for the cd command. 

MAIL If this parameter is set to the name of a mail file and the MAILPATH parameter is not set, 
then the shell informs the user of arrival of mail in the specified file. 

MAILCHECK 
This variable specifies how often (in seconds) the shell will check for changes in the 
modification time of any of the files specified by the MAILPATH or MAIL parameters. 
The default value is 600 seconds. If set to 0, the shell will check before each prompt. 

MAILPATH 
A colon (: ) separated list of file names. If this parameter is set then the shell informs the 
user of any modifications to the specified files that have occurred within the last 
MAILCHECK seconds. Each file name can be followed by a ? and a message that will be 
printed. The message will undergo parameter and command substitution with the param- 
eter, $_ defined as the name of the file that has changed. The default message is you have 
mail in $_. 

PATH The search path for commands (see Execution below). The user may not change PATH if 
executing under rsh (except in .profile ). 

PS1 The value of this parameter is expanded for paramter substitution to define the primary 
prompt string which by default is ‘‘$ ’’. The character ! in the primary prompt string is 
replaced by the command number (see Command Re-entry below). 

PS2 Secondary prompt string, by default “‘> ”’. 

PS3 Selection prompt string used within a select loop, by default ‘‘“#? ”’. 

SHELL The pathname of the shell is kept in the environment. At invocation, if the value of this 
variable contains an r in the basename, then the shell becomes restricted. 
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TMOUT 
If set to a value greater than zero, the shell will terminate if a command is not entered 
within the prescribed number of seconds. (Note that the shell can be compiled with a 
maximum bound for this value which cannot be exceeded.) 

VISUAL 
If the value of this variable ends in emacs, gmacs, or vi then the corresponding option 
(see Special Command set below) will be turned on. 


The shell gives default values to PATH, PS1, PS2, MAILCHECK, TMOUT and IFS, while HOME, SHELL 
ENV and MAIL are not set at all by the shell (although HOME is set by Jogin(1)). On some systems MAIL 
and SHELL are also set by Jogin(1)). 


Blank Interpretation. 


After parameter and command substitution, the results of substitutions are scanned for the field separator 
characters ( those found in IFS ) and split into distinct arguments where such characters are found. Explicit 
null arguments (''" or ) are retained. Implicit null arguments (those resulting from parameters that have 
no values) are removed. 


File Name Generation. 


Following substitution, each command word is scanned for the characters *, ?, and [ unless the -f option 
has been set. If one of these characters appears then the word is regarded as a pattern. The word is 
replaced with alphabetically sorted file names that match the pattern. If no file name is found that matches 
the pattern, then the word is left unchanged. When a pattern is used for file name generation, the character 
. at the start of a file name or immediately following a /, as well as the character / itself, must be matched 
explicitly. In other instances of pattern matching the / and . are not treated specially. 


* Matches any string, including the null string. 
Matches any single character. 

[...] | Matches any one of the enclosed characters. A pair of characters separated by — matches 
any character lexically between the pair, inclusive. If the first character following the 
opening "[ "isa"! " then any character not enclosed is matched. A — can be included in 
the character set by putting it as the first or last character. 


Quoting. 


Each of the metacharacters listed above (See Definitions above). has a special meaning to the shell and 
cause termination of a word unless quoted. A character may be quoted (i.e., made to stand for itself) by 
preceding it with a\. The pair \new-line is ignored. All characters enclosed between a pair of single quote 
marks (’’), except a single quote, are quoted. Inside double quote marks (''"'), parameter and command 
substitution occurs and \ quotes the characters \, ’, '', and $. ''$*"' is equivalent to "$1 $2 ...', whereas 
"$@" is equivalent to "$1" "$2" .... 


The special meaning of keywords can be removed by quoting any character of the keyword. The recogni- 
tion of special command names listed below cannot be altered by quoting them. 


Arithmetic Evaluation. 


An ability to perform integer arithmetic is provided with the special command let. Evaluations are per- 
formed using Jong arithmetic. Constants are of the form [base#]n where base is a decimal number 
between two and thirty-six representing the arithmetic base and n is a number in that base. If base is omit- 
ted then base 10 is used. 


An internal integer representation of a named parameter can be specified with the -i option of the typeset 
special command. When this attribute is selected the first assignment to the parameter determines the arith- 
metic base to be used when parameter substitution occurs. 


Since many of the arithmetic operators require quoting, an alternative form of the let command is provided. 
For any command which begins with a ((, all the characters until a matching )) are treated as a quoted 
expression. More precisely, ((... )) is equivalent to let " ..."'. 
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Prompting. 


When used interactively, the shell prompts with the value of PS1 before reading a command. If at any time 
a new-line is typed and further input is needed to complete a command, then the secondary prompt (i.e., the 
value of PS2) is issued. 


Input/Output. 


Before a command is executed, its input and output may be redirected using a special notation interpreted 
by the shell. The following may appear anywhere in a simple-command or may precede or follow a 
command and are not passed on to the invoked command. Command and parameter substitution occurs 
before word or digit is used except as noted below. File name generation occurs only if the pattern matches 
a single file and blank interpretation is not performed. 


<word Use file word as standard input (file descriptor 0). 


>word Use file word as standard output (file descriptor 1). If the file does not exist then it is cre- 
ated; otherwise, it is truncated to zero length. 


>>word Use file word as standard output. If the file exists then output is appended to it (by first 
seeking to the end-of-file); otherwise, the file is created. 


<[-]word The shell input is read up to a line that is the same as word, or to an end-of-file. No 
parameter substitution, command substitution or file name generation is performed on 
word. The resulting document, called a here-document, becomes the standard input. If 
any character of word is quoted, then no interpretation is placed upon the characters of the 
document; otherwise, parameter and command substitution occurs, \new-line is ignored, 
and \ must be used to quote the characters \, $, *, and the first character of word. If — is 
appended to <, then all leading tabs are stripped from word and from the document. 


<&digit The standard input is duplicated from file descriptor digit (see dup(2)). Similarly for the 
standard output using >& digit. 


<&- The standard input is closed. Similarly for the standard output using >&-. 


If one of the above is preceded by a digit, then the file descriptor number referred to is that specified by the 
digit (instead of the default 0 or 1). For example: 


... 2>&1 
means file descriptor 2 is to be opened for writing as a duplicate of file descriptor 1. 


The order in which redirections are specified is significant. The shell evaluates each redirection in terms of 
the (file descriptor, file) association at the time of evaluation. For example: 


... L>fname 2>&1 


first associates file descriptor 1 with file fname. It then associates file descriptor 2 with the file associated 
with file descriptor 1 (i.e. fname). If the order of redirections were reversed, file descriptor 2 would be 
associated with the terminal (assuming file descriptor 1 had been) and then file descriptor 1 would be asso- 
ciated with file fname . 


If a command is followed by & and job control is not active, then the default standard input for the com- 
mand is the empty file /dev/null. Otherwise, the environment for the execution of a command contains the 
file descriptors of the invoking shell as modified by input/output specifications. 


Environment. 
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The environment (see environ(7)) is a list of name-value pairs that is passed to an executed program in the 
same way as a normal argument list. The names must be identifiers and the values are character strings. 
The shell interacts with the environment in several ways. On invocation, the shell scans the environment 
and creates a parameter for each name found, giving it the corresponding value and marking it export . Exe- 
cuted commands inherit the environment. If the user modifies the values of these parameters or creates new 
ones, using the export or typeset —-x commands they become part of the environment. The environment 
seen by any executed command is thus composed of any name-value pairs originally inherited by the shell, 
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whose values may be modified by the current shell, plus any additions which must be noted in export or 
typeset —x commands. 


The environment for any simple-command or function may be augmented by prefixing it with one or more 
parameter assignments. A parameter assignment argument is a word of the form identifier=value. Thus: 


TERM=450 cmd args and 
(export TERM; TERM=450; cmd args) 
are equivalent (as far as the above execution of cmd is concerned). 


If the -k flag is set, all parameter assignment arguments are placed in the environment, even if they occur 
after the command name. The following first prints a=b c and then e: 


echo a=b c 
set —k 
echo a=b c 


Functions. 


Jobs. 


The function keyword, described in the Commands section above, is used to define shell functions. Shell 
functions are read in and stored internally. Alias names are resolved when the function is read. Functions 
are executed like commands with the arguments passed as positional parameters. (See Execution below). 


Functions execute in the same process as the caller and share all files, traps ( other than EXIT and ERR) and 
present working directory with the caller. A trap set on EXIT inside a function is executed after the func- 
tion completes. Ordinarily, variables are shared between the calling program and the function. However, 
the typeset special command used within a function defines local variables whose scope includes the cur- 
rent function and all functions it calls. 


The special command return is used to return from function calls. Errors within functions return control to 
the caller. 


Function identifiers can be listed with the -f option of the typeset special command. The text of functions 
will also be listed. Function can be undefined with the -f option of the unset special command. 


Ordinarily, functions are unset when the shell executes a shell script. The —xf option of the typeset com- 
mand allows a function to be exported to scripts that are executed without a separate invocation of the shell. 
Functions that need to be defined across separate invocations of the shell should be placed in the ENV file. 


If the monitor option of the set command is turned on, an interactive shell associates a job with each pipe- 
line. It keeps a table of current jobs, printed by the jobs command, and assigns them small integer num- 
bers. When a job is started asynchronously with &, the shell prints a line which looks like: 


[1] 1234 


indicating that the job which was started asynchronously was job number | and had one (top-level) process, 
whose process id was 1234. 


This paragraph and the next require features that are not in all versions of UNIX and may not apply. If you 
are running a job and wish to do something else you may hit the key *Z (control-Z) which sends a STOP 
signal to the current job. The shell will then normally indicate that the job has been ‘Stopped’, and print 
another prompt. You can then manipulate the state of this job, putting it in the background with the bg 
command, or run some other commands and then eventually bring the job back into the foreground with the 
foreground command fg. A *Z takes effect immediately and is like an interrupt in that pending output and 
unread input are discarded when it is typed. 


A job being run in the background will stop if it tries to read from the terminal. Background jobs are nor- 
mally allowed to produce output, but this can be disabled by giving the command ‘‘stty tostop’’. If you set 
this tty option, then background jobs will stop when they try to produce output like they do when they try to 
read input. 
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There are several ways to refer to jobs in the shell. The character % introduces a job name. If you wish to 
refer to job number 1, you can name it as %1. Jobs can also be named by prefixes of the string typed in to 
kill or restart them. Thus, on systems that support job control, ‘fg %ed’ would normally restart a sus- 
pended ed(1) job, if there were a suspended job whose name began with the string ‘ed’. 


The shell maintains a notion of the current and previous jobs. In output pertaining to jobs, the current job is 
marked with a + and the previous job with a -. The abbreviation %+ refers to the current job and %- 
refers to the previous job. % % is also a synonym for the current job. 


This shell learns immediately whenever a process changes state. It normally informs you whenever a job 
becomes blocked so that no further progress is possible, but only just before it prints a prompt. This is done 
so that it does not otherwise disturb your work. 


When you try to leave the shell while jobs are running or stopped, you will be warned that ‘You have 
stopped(running) jobs.” You may use the jobs command to see what they are. If you do this or immedi- 
ately try to exit again, the shell will not warn you a second time, and the stopped jobs will be terminated. 


Signals. 
The INT and QUIT signals for an invoked command are ignored if the command is followed by & and job 
monitor option is not active. Otherwise, signals have the values inherited by the shell from its parent, with 
the exception of signal 11 (but see also the trap command below). 


Execution. 

Each time a command is executed, the above substitutions are carried out. If the command name matches 
one of the Special Commands listed below, it is executed within the current shell process. Next, the com- 
mand name is checked to see if it matches one of the user defined functions. If it does, the positional 
parameters are saved and then reset to the arguments of the function call. When the function completes or 
issues a return, the positional parameter list is restored and any trap set on EXIT within the function is exe- 
cuted. The value of a function is the value of the last command executed. A function is also executed in 
the current shell process. If a command name is not a special command or a user defined function, a pro- 
cess is created and an attempt is made to execute the command via exec (2). 


The shell parameter PATH defines the search path for the directory containing the command. Alternative 
directory names are separated by a colon (:). The default path is :/bin:/usr/bin (specifying the current 
directory, /bin, and /usr/bin, in that order). Note that the current directory is specified by a null path name, 
which can appear immediately after the equal sign, between colon delimiters, or at the end of the path list. 
If the command name contains a / then the search path is not used. Otherwise, each directory in the path is 
searched for an executable file. If the file has execute permission but is not a directory or an a.out file, it is 
assumed to be a file containing shell commands. A sub-shell is spawned to read it. All non-exported 
aliases, functions, and named parameters are removed in this case. A parenthesized command is also exe- 
cuted in a sub-shell. 


Command Re-entry. 

The text of the last HISTSIZE (default 128) commands entered from a terminal device is saved in a history 
file. The file $HOME/history is used if the HISTFILE variable is not set or is not writable. A shell can 
access the commands of all interactive shells which use the same named HISTFILE. The special command 
fe is used to list or edit a portion this file. The portion of the file to be edited or listed can be selected by 
number or by giving the first character or characters of the command. A single command or range of com- 
mands can be specified. If you do not specify an editor program as an argument to fe then the value of the 
parameter FCEDIT is used. If FCEDIT is not defined then /bin/ed is used. The edited command(s) is 
printed and re-executed upon leaving the editor. The editor name — is used to skip the editing phase and to 
re-execute the command. In this case a substitution parameter of the form old=new can be used to modify 
the command before execution. For example, if r is aliased to ‘fe -e —’ then typing ‘r bad=good c’ will re- 
execute the most recent command which starts with the letter c, replacing the string bad with the string 
good. 


In-line Editing Options 
Normally, each command line entered from a terminal device is simply typed followed by a new-line 
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(‘RETURN’ or ‘LINE FEED’). If either the emacs, gmacs, or vi option is active, the user can edit the com- 
mand line. To be in either of these edit modes set the corresponding option. An editing option is automati- 
cally selected each time the VISUAL or EDITOR variable is assigned a value ending in either of these 
option names. 


The editing features require that the user’s terminal accept ‘RETURN’ as carriage return without line feed 
and that a space (‘’ must overwrite the current character on the screen. ADM terminal users should set the 
"space - advance" switch to ‘space’. Hewlett-Packard series 2621 terminal users should set the straps to 
“‘pbcGHxZ etX’. 


The editing modes implement a concept where the user is looking through a window at the current line. 
The window width is the value of COLUMNS if it is defined, otherwise 80. If the line is longer than the 
window width minus two, a mark is displayed at the end of the window to notify the user. As the cursor 
moves and reaches the window boundaries the window will be centered about the cursor. The mark is a > ( 
<, *) if the line extends on the right (left, both) side(s) of the window. 


Emacs Editing Mode 


This mode is entered by enabling either the emacs or gmacs option. The only difference between these two 
modes is the way they handle “T. To edit, the user moves the cursor to the point needing correction and 
then inserts or deletes characters or words as needed. All the editing commands are control characters or 
escape sequences. The notation for control characters is caret (* ) followed by the character. For example, 
“F is the notation for control F. This is entered by depressing ‘f? while holding down the ‘CTRL’ (control) 
key. The ‘SHIFT’ key is not depressed. (The notation *? indicates the DEL (delete) key.) 


The notation for escape sequences is M- followed by a character. For example, M-f (pronounced Meta f) is 
entered by depressing ESC (ascii 033 ) followed by ‘f?. ( M-F would be the notation for ESC followed by 
‘SHIFT’ (capital) ‘F’.) 


All edit commands operate from any place on the line (not just at the beginning). Neither the "RETURN" 
nor the "LINE FEED" key is entered after edit commands except when noted. 


“F Move cursor forward (right) one character. 

M-f Move cursor forward one word. (The editor’s idea of a word is a string of characters consisting 
of only letters, digits and underscores.) 

“B Move cursor backward (left) one character. 

M-b Move cursor backward one word. 

“A Move cursor to start of line. 

“E Move cursor to end of line. 

*|char Move cursor to character char on current line. 

“x’x Interchange the cursor and mark. 

erase (User defined erase character as defined by the stty command, usually “H or #.) Delete previ- 
ous character. 

“D Delete current character. 

M-d Delete current word. 

M-*H (Meta-backspace) Delete previous word. 

M-h Delete previous word. 

M-*? (Meta-DEL) Delete previous word (if your interrupt character is *? (DEL, the default) then this 
command will not work). 

“T Transpose current character with next character in emacs mode. Transpose two previous char- 
acters in gmacs mode. 

°C Capitalize current character. 

M-C Capitalize current word. 

“K Kill from the cursor to the end of the line. If given a parameter of zero then kill from the start 
of line to the cursor. 

“W Kill from the cursor to the mark. 

M-p Push the region from the cursor to the mark on the stack. 
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kill (User defined kill character as defined by the stty command, usually “G or @.) Kill the entire 
current line. If two kill characters are entered in succession, all kill characters from then on 
cause a line feed (useful when using paper terminals). 

“Y Restore last item removed from line. (Yank item back to the line.) 

“L Line feed and print current line. 

*@ (Null character) Set mark. 

M- (Meta space) Set mark. 

“J (New line) Execute the current line. 

“M (Return) Execute the current line. 

eof End-of-file character, normally “D, will terminate the shell if the current line is null. 

=P. Fetch previous command. Each time *P is entered the previous command back in time is 
accessed. 

M-< Fetch the least recent (oldest) history line. 

M-> Fetch the most recent (youngest) history line. 

“N Fetch next command. Each time “N is entered the next command forward in time is accessed. 


“Rstring Reverse search history for a previous command line containing string. If a parameter of zero is 
given the search is forward. String is terminated by a "RETURN" or "NEW LINE". 

‘O Operate — Execute the current line and fetch the next line relative to current line from the his- 
tory file. 

M-digits (Escape) Define numeric parameter, the digits are taken as a parameter to the next command. 

The commands that accept a parameter are “F, “B, erase, “D, “K, “R, “P and “N. 

M-letter | Soft-key — Your alias list is searched for an alias by the name etter and if an alias of this 

name is defined, its value will be inserted on the line. The /etter must not be one of the above 

meta-functions. 


M-_ The last parameter of the previous command is inserted on the line. 

M-. The last parameter of the previous command is inserted on the line. 

M-* Attempt file name generation on the current word. 

‘U Multiply parameter of next command by 4. 

\ Escape next character. Editing characters, the user’s erase, kill and interrupt (normally *? ) 


characters may be entered in a command line or in a search string if preceded by a \. The \ 
removes the next character’s editing features (if any). 
“Vv Display version of the shell. 


Editing Mode 
There are two typing modes. Initially, when you enter a command you are in the input mode. To edit, the 
user enters control mode by typing ESC ( 033 ) and moves the cursor to the point needing correction and 
then inserts or deletes characters or words as needed. Most control commands accept an optional repeat 
count prior to the command. 
When in vi mode on most systems, canonical processing is initially enabled and the command will be 
echoed again if the speed is 1200 baud or greater and it contains any control characters or less than one sec- 
ond has elapsed since the prompt was printed. The ESC character terminates canonical processing for the 
remainder of the command and the user can than modify the command line. This scheme has the advan- 
tages of canonical processing with the type-ahead echoing of raw mode. 
If the option viraw is also set, the terminal will always have canonical processing disabled. This mode is 
implicit for systems that do not support two alternate end of line delimiters, and may be helpful for certain 
terminals. 


Input Edit Commands 
By default the editor is in input mode. 


erase (User defined erase character as defined by the stty command, usually “H or #.) 
Delete previous character. 

“W Delete the previous blank separated word. 

“‘D Terminate the shell. 

“Vv Escape next character. Editing characters, the user’s erase or kill characters may be 


entered in a command line or in a search string if preceded by a*V. The “V removes 
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the next character’s editing features (if any). 
Escape the next erase or kill character. 


These commands will move the cursor. 


Search Edit Commands 


Cursor forward (right) one character. 

Cursor forward one alpha-numeric word. 

Cursor to the beginning of the next word that follows a blank. 
Cursor to end of word. 

Cursor to end of the current blank delimited word. 

Cursor backward (left) one character. 

Cursor backward one word. 

Cursor to preceding blank separated word. 

Find the next character c in the current line. 

Find the previous character c in the current line. 

Equivalent to f followed by h. 

Equivalent to F followed by I. 

Repeats the last single character find command, f, F, t, or T. 
Reverses the last single character find command. 

Cursor to start of line. 

Cursor to first non-blank character in line. 

Cursor to end of line. 


These commands access your command history. 


[count|k 


[count|— 
[count]j 


[count]+ 
[count|G 


/string 
? string 


n 
N 


Fetch previous command. Each time k is entered the previous command back in time 
is accessed. 

Equivalent to k. 

Fetch next command. Each time j is entered the next command forward in time is 
accessed. 

Equivalent to j. 

The command number count is fetched. The default is the least recent history com- 
mand. 

Search backward through history for a previous command containing string. String is 
terminated by a "RETURN" or "NEW LINE". If string is null the previous string will 
be used. 

Same as / except that search will be in the forward direction. 

Search for next match of the last pattern to / or ? commands. 

Search for next match of the last pattern to / or ?, but in reverse direction. Search his- 
tory for the string entered by the previous / command. 


Text Modification Edit Commands 
These commands will modify the line. 


a Enter input mode and enter text after the current character. 

A Append text to the end of the line. Equivalent to $a. 

[count|emotion 

c[count|motion 
Delete current character through the character motion moves the cursor to and enter 
input mode. If motion is c, the entire line will be deleted and input mode entered. 

C Delete the current character through the end of line and enter input mode. Equivalent 
to c$. 

S Equivalent to cc. 

D Delete the current character through the end of line. 

[count|dmotion 

d[count|motion 


Delete current character through the character motion moves the cursor to. Equivalent 
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to d$. If motion is d , the entire line will be deleted. 

Enter input mode and insert text before the current character. 

Insert text before the beginning of the line. Equivalent to the two character sequence 
Place the previous text modification before the cursor. 

Place the previous text modification after the cursor. 

Enter input mode and replace characters on the screen with characters you type over- 
lay fashion. 

Replace the current character with c. 

Delete current character. 

Delete preceding character. 

Repeat the previous text modification command. 

Invert the case of the current character and advance the cursor. 

Causes the count word of the previous command to be appended and input mode 
entered. The last word is used if count is omitted. 

Causes an * to be appended to the current word and file name generation attempted. 
If no match is found, it rings the bell. Otherwise, the word is replaced by the match- 
ing pattern and input mode is entered. 


Miscellaneous commands. 


Special Commands. 


Undo the last text modifying command. 

Undo all the text modifying commands performed on the line. 

Returns the command fe -e ${ VISUAL:-${EDITOR:—vi}} count in the input buffer. If 
count is omitted, then the current line is used. 

Line feed and print current line. Has effect only in control mode. 

(New line) Execute the current line, regardless of mode. 

(Return) Execute the current line, regardless of mode. 

Equivalent to I#<cr>. Useful for causing the current line to be inserted in the history 
without being executed. 


The following simple-commands are executed in the shell process. Input/Output redirection is permitted. 
File descriptor 1 is the default output location. Parameter assignment lists preceding the command do not 
remain in effect when the command completes unless noted. 


:Larg... ] 


Parameter assignments remain in effect after the command completes. The command only 
expands parameters. A zero exit code is returned. 


. file [ arg... ] 


Parameter assignments remain in effect after the command completes. Read and execute com- 
mands from file and return. The commands are executed in the current Shell environment. The 
search path specified by PATH is used to find the directory containing file. If any arguments arg 
are given, they become the positional parameters. Otherwise the positional parameters are 


unchanged. 


alias [ -tx ] [ name[ =value ] ... ] 
Alias with no arguments prints the list of aliases in the form name=value on standard output. An 
alias is defined for each name whose value is given. A trailing space in value causes the next 
word to be checked for alias substitution. The -t flag is used to set and list tracked aliases. The 
value of a tracked alias is the full pathname corresponding to the given name. The value becomes 
undefined when the value of PATH is reset but the aliases remained tracked. Without the -t flag, 
for each name in the argument list for which no value is given, the name and value of the alias is 
printed. The -x flag is used to set or print exported aliases. An exported alias is defined across 
sub-shell environments. Alias returns true unless a name is given for which no alias has been 


defined. 
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bg[ %job ] 
This command is only built-in on systems that support job control. Puts the specified job into the 
background. The current job is put in the background if job is not specified. 


break [ 1 ] 
Exit from the enclosing for while until or select loop, if any. If is specified then break n levels. 


continue [ 7 | 
Resume the next iteration of the enclosing for while until or select loop. If n is specified then 
resume at the n-th enclosing loop. 


cd [ arg | 

ed old new 
This command can be in either of two forms. In the first form it changes the current directory to 
arg. If arg is — the directory is changed to the previous directory. The shell parameter HOME is 
the default arg. The parameter PWD is set to the current directory. The shell parameter CDPATH 
defines the search path for the directory containing arg. Alternative directory names are separated 
by acolon (:). The default path is <null> (specifying the current directory). Note that the current 
directory is specified by a null path name, which can appear immediately after the equal sign or 
between the colon delimiters anywhere else in the path list. If arg begins with a / then the search 
path is not used. Otherwise, each directory in the path is searched for arg. 
The second form of cd substitutes the string new for the string old in the current directory name, 
PWD and tries to change to this new directory. 
The cd command may not be executed by rsh. 


eval [ arg... | 
The arguments are read as input to the shell and the resulting command(s) executed. 


exec [ arg... | 
Parameter assignments remain in effect after the command completes. If arg is given, the com- 
mand specified by the arguments is executed in place of this shell without creating a new process. 
Input/output arguments may appear and affect the current process. If no arguments are given the 
effect of this command is to modify file descriptors as prescribed by the input/output redirection 
list. In this case, any file descriptor numbers greater than 2 that are opened with this mechanism 
are closed when invoking another program. 


exit [n ] 
Causes the shell to exit with the exit status specified by n. If n is omitted then the exit status is 
that of the last command executed. An end-of-file will also cause the shell to exit except for a 
shell which has the ignoreeof option (See set below) turned on. 


export [ name... | 
The given names are marked for automatic export to the environment of subsequently-executed 
commands. 


fe [ -eename ]|[ -nlr ][ first | [ last ] 

fe -e — [ old=new |[ command | 
In the first form, a range of commands from first to last is selected from the last HISTSIZE com- 
mands that were typed at the terminal. The arguments first and last may be specified as a number 
or as a string. A string is used to locate the most recent command starting with the given string. A 
negative number is used as an offset to the current command number. If the flag 41, is selected, the 
commands are listed on standard output. Otherwise, the editor program ename is invoked on a file 
containing these keyboard commands. If ename is not supplied, then the value of the parameter 
FCEDIT (default /bin/ed) is used as the editor. When editing is complete, the edited command(s) 
is executed. /ast is not specified then it will be set to first. If first is not specified the default is the 
previous command for editing and —16 for listing. The flag -r reverses the order of the commands 
and the flag —-n suppresses command numbers when listing. In the second form the command is 
re-executed after the substitution old=new is performed. 
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fg[ Zojob | 


This command is only built-in on systems that support job control. If job is specified it brings it to 
the foreground. Otherwise, the current job is brought into the foreground. 


jobs [ -1 ] 


Lists the active jobs; given the -] options lists process id’s in addition to the normal information. 


kill [ -sig ] process ... 


let arg .. 


newerp 


Sends either the TERM (terminate) signal or the specified signal to the specified jobs or processes. 
Signals are either given by number’ or by names (as_ given’ in 
/media/acher/Games/v8/usr/include/signal.h, stripped of the prefix ‘‘SIG’’). The signal names are 
listed by kill -l’. There is no default, saying just ‘kill’ does not send a signal to the current job. If 
the signal being sent is TERM (terminate) or HUP (hangup), then the job or process will be sent a 
CONT (continue) signal if it is stopped. The argument process can be either a process id or a job. 


Each arg is an arithmetic expression to be evaluated. All calculations are done as long integers 
and no check for overflow is performed. Expressions consist of constants, named parameters, and 
operators. The following set of operators, listed in order of decreasing precedence, have been 


implemented: 
- unary minus 
! logical negation 
* | % 
multiplication, division, remainder 
+ addition, subtraction 
<= >= <> 
comparison 


=- != 
equality inequality 
= arithmetic replacement 
Sub-expressions in parentheses () are evaluated first and can be used to override the above prece- 


dence rules. The evaluation within a precedence group is from right to left for the = operator and 
from left to right for the others. 


A parameter name must be a valid identifier. When a parameter is encountered, the value associ- 
ated with the parameter name is substituted and expression evaluation resumes. Up to nine levels 
of recursion are permitted. 


The return code is 0 if the value of the last expression is non-zero, and 1 otherwise. 


[ arg... ] 
Equivalent to exec newgrp arg .... 


print [ -—Rnprsu[7 ] ][ arg... ] 


The shell output mechanism. With no flags or with flag -, the arguments are printed on standard 
output as described by echo(1). In raw mode, —R or -r, the escape conventions of echo are 
ignored. The —-R option will print all subsequent arguments and options other than —n. The —p 
option causes the arguments to be written onto the pipe of the process spawned with | & instead of 
standard output. The -s option causes the arguments to be written onto the history file instead of 
standard output. The —u flag can be used to specify a one digit file descriptor unit number n on 
which the output will be placed. The default is 1. If the flag —-n is used, no new-line is added to 
the output. 


read [ -prsu[ 1 ] ][ name?prompt |[ name... | 


The shell input mechanism. One line is read and is broken up into words using the characters in 
IFS as separators. In raw mode, -r, a \ at the end of a line does not signify line continuation. The 
first word is assigned to the first name, the second word to the second name, etc., with leftover 
words assigned to the last name. The —-p option causes the input line to be taken from the input 
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pipe of a process spawned by the shell using | &. If the -s fag is present, the input will be saved as 
a command in the history file. The flag —-u can be used to specify a one digit file descriptor unit to 
read from. The file descriptor can be opened with the exec special command. The default value of 
n is 0. If name is omitted then REPLY is used as the default name. The return code is 0 unless an 
end-of-file is encountered. An end-of-file with the —p option causes cleanup for this process so 
that another can be spawned. If the first argument contains a ?, the remainder of this word is used 
as a prompt when the shell is interactive. If the given file descriptor is open for writing and is a 
terminal device then the prompt is placed on this unit. Otherwise the prompt is issued on file 
descriptor 2. The return code is 0 unless an end-of-file is encountered. 


readonly [ name... | 
The given names are marked readonly and these names cannot be changed by subsequent assign- 


ment. 


return [ 7 | 


Causes a shell function to return to the invoking script with the return status specified by n. If n is 
omitted then the return status is that of the last command executed. If return is invoked while not 
in a function then it is the same as an exit. 


set [ -aefhkmnostuvx ] [ -o option ... |[ arg... ] 
The flags for this command have meaning as follows: 


—a 


All subsequent parameters that are defined are automatically exported. 
If the shell is non-interactive and if a command fails, execute the ERR trap, if set, and 
exit immediately. This mode is disabled while reading profiles. 
Disables file name generation. 
Each command whose name is an identifier becomes a tracked alias when first encoun- 
tered. 
All parameter assignment arguments are placed in the environment for a command, not 
just those that precede the command name. 
Background jobs will run in a separate process group and a line will print upon comple- 
tion. The exit status of background jobs is reported in a completion message. On sys- 
tems with job control, this flag is turned on automatically for interactive shells. 
Read commands but do not execute them. 
The following argument can be one of the following option names: 
allexport 
Same as —a. 
errexit Same as -e. 
emacs Puts you in an emacs style in-line editor for command entry. 
gmacs_ Puts you ina gmacs style in-line editor for command entry. 
ignoreeof 
The shell will not exit on end-of-file. The command exit must be used. 
keyword 
Same as -k. 
markdirs 
All directory names resulting from file name generation have a trailing / 
appended. 
monitor Same as —m. 
noexec Same as —n. 
noglob Same as -f. 
nounset Same as -u. 
verbose Same as -V. 
trackall Same as —h. 
vi Puts you in insert mode of a vi style in-line editor until you hit escape charac- 
ter 033. This puts you in move mode. A return sends the line. 
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viraw _ Each character is processed as it is typed in vi mode. 
xtrace Same as —-x. 
If no option name is supplied then the current option settings are printed. 

-s Sort the positional parameters. 
-t Exit after reading and executing one command. 
-u Treat unset parameters as an error when substituting. 
-v Print shell input lines as they are read. 
-x Print commands and their arguments as they are executed. 
- Turns off —x and —v flags and stops examining arguments for flags. 
— Do not change any of the flags; useful in setting $1 to a value beginning with -. If no 

arguments follow this flag then the positional parameters are unset. 
Using + rather than — causes these flags to be turned off. These flags can also be used upon invo- 
cation of the shell. The current set of flags may be found in $-. The remaining arguments are 
positional parameters and are assigned, in order, to 
$1, $2, .... If no arguments are given then the values of all names are printed on the standard out- 
put. 
The positional parameters from $n+1... are renamed $1... , default n is 1. The parameter n can 


be any arithmetic expression that evaluates to a non-negative number less than or equal to $#. 


test [ expr ] 


Evaluate conditional expression expr. See test(1) for usage and description. The arithmetic com- 
parison operators are not restricted to integers. They allow any arithmetic expression. Four addi- 
tional primitive expressions are allowed: 
-L file True if file is a symbolic link. 
filel —nt file2 
True if file] is newer than file2. 
filel -ot file2 
True if file/ is older than file2. 
filel —ef file2 
True if file] has the same device and i-node number as file2. 


Print the accumulated user and system times for the shell and for processes run from the shell. 


trap [ arg |[ sig ]... 


arg is acommand to be read and executed when the shell receives signal(s) sig. (Note that arg is 
scanned once when the trap is set and once when the trap is taken.) Each sig can be given as a 
number or as the name of the signal. Trap commands are executed in order of signal number. 
Any attempt to set a trap on a signal that was ignored on entry to the current shell is ineffective. 
An attempt to trap on signal 11 (memory fault) produces an error. If arg is omitted or is —, then all 
trap(s) sig are reset to their original values. If arg is the null string then this signal is ignored by 
the shell and by the commands it invokes. If sig is ERR then arg will be executed whenever a 
command has a non-zero exit code. This trap is not inherited by functions. If sig is 0 or EXIT and 
the trap statement is executed inside the body of a function, then the command arg is executed 
after the function completes. If sig is 0 or EXIT for a trap set outside any function then the com- 
mand arg is executed on exit from the shell. The trap command with no arguments prints a list of 
commands associated with each signal number. 


typeset | -FLRZefilprtux[n | [ name[ =value |] ] ... ] 


Parameter assignments remain in effect after the command completes. When invoked inside a 
function, a new instance of the parameter name is created. The parameter value and type are 
restored when the function completes. The following list of attributes may be specified: 
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—-F This flag provides UNIX to host-name file mapping on non-UNIX machines. 

-L Left justify and remove leading blanks from value. If n is non-zero it defines the width of 
the field, otherwise it is determined by the width of the value of first assignment. When 
the parameter is assigned to, it is filled on the right with blanks or truncated, if necessary, 
to fit into the field. Leading zeros are removed if the —Z flag is also set. The -R flag is 
turned off. 

-R Right justify and fill with leading blanks. If is non-zero it defines the width of the field, 
otherwise it is determined by the width of the value of first assignment. The field is left 
filled with blanks or truncated from the end if the parameter is reassigned. The L flag is 
turned off. 

-Z Right justify and fill with leading zeros if the first non-blank character is a digit and the 
-L flag has not been set. If n is non-zero it defines the width of the field, otherwise it is 
determined by the width of the value of first assignment. 


-e Tag the parameter as having an error. This tag is currently unused by the shell and can be 
set or cleared by the user. 

-f The names refer to function names rather than parameter names. No assignments can be 
made and the only other valid flag is —x. 

-i Parameter is an integer. This makes arithmetic faster. If 1 is non-zero it defines the out- 
put arithmetic base, otherwise the first assignment determines the output base. 

-l All upper-case characters converted to lower-case. The upper-case flag, —u is turned off. 

-p The output of this command, if any, is written onto the two-way pipe 

-r The given names are marked readonly and these names cannot be changed by subsequent 
assignment. 

-t Tags the named parameters. Tags are user definable and have no special meaning to the 
shell. 

-u All lower-case characters are converted to upper-case characters. The lower-case flag, —l 
is turned off. 

-x The given names are marked for automatic export to the environment of subsequently- 


executed commands. 


Using + rather than — causes these flags to be turned off. If no name arguments are given but flags 
are specified, a list of names (and optionally the values ) of the parameters which have these flags 
set is printed. (Using + rather than — keeps the values to be printed.) If no names and flags are 
given, the names and attributes of all parameters are printed. 


ulimit [ -cdfmpt ] [7 ] 


umask [ 


— imposes a size limit of n blocks on the size of core dumps (BSD only). 

-d imposes a size limit of n blocks on the size of the data area (BSD only). 

-f imposes a size limit of n blocks on files written by child processes (files of any size may 
be read). 

—m imposes a soft limit of n blocks on the size of physical memory (BSD only). 

-p changes the pipe size to n (UNIX/RT only). 

-t imposes a time limit of n seconds to be used by each process (BSD only). 


If no option is given, -f is assumed. If n is not given the current limit is printed. 


nnn | 
The user file-creation mask is set to nnn (see umask(2)). If nnn is omitted, the current value of the 
mask is printed. 


unalias name ... 


The parameters given by the list of names are removed from the alias list. 


unset [ -f ] name... 


The parameters given by the list of names are unassigned, i. e., their values and attributes are 
erased. Readonly variables cannot be unset. If the flag, -f, is set, then the names refer to function 
names. 
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wait [ 1 ] 
Wait for the specified process and report its termination status. If n is not given then all currently 
active child processes are waited for. The return code from this command is that of the process 
waited for. 


whence [ -v | name... 
For each name, indicate how it would be interpreted if used as a command name. 
The flag, —v, produces a more verbose report. 


Invocation. 


If the shell is invoked by exec(2), and the first character of argument zero ($0) is -, then the shell is 
assumed to be a login shell and commands are read from /etc/profile and then from either .profile in the 
current directory or $HOME/.profile, if either file exists. Next, commands are read from the file named by 
performing parameter substitution on the value of the environment parameter ENV if the file exists. Com- 
mands are then read as described below; the following flags are interpreted by the shell when it is invoked: 


-c string If the -c flag is present then commands are read from string. 

-s If the -s flag is present or if no arguments remain then commands are read from the standard 
input. Shell output, except for the output of some of the Special commands listed above, is 
written to file descriptor 2. 

-i If the -i flag is present or if the shell input and output are attached to a terminal (as told by 
gtty(2)) then this shell is interactive. In this case TERMINATE is ignored (so that kill 0 does 
not kill an interactive shell) and INTERRUPT is caught and ignored (so that wait is interrupt- 
ible). In all cases, QUIT is ignored by the shell. 

-r If the -r flag is present the shell is a restricted shell. 


The remaining flags and arguments are described under the set command above. 


Rsh Only. 


Rsh is used to set up login names and execution environments whose capabilities are more controlled than 
those of the standard shell. The actions of rsh are identical to those of sh, except that the following are dis- 
allowed: 

changing directory (see cd(1)), 

setting the value of SHELL or PATH, 

specifying path or command names containing /, 

redirecting output (> and >>). 


The restrictions above are enforced after .profile and the ENV files are interpreted. 


When a command to be executed is found to be a shell procedure, rsh invokes sh to execute it. Thus, it is 
possible to provide to the end-user shell procedures that have access to the full power of the standard shell, 
while imposing a limited menu of commands; this scheme assumes that the end-user does not have write 
and execute permissions in the same directory. 


The net effect of these rules is that the writer of the .profile has complete control over user actions, by per- 
forming guaranteed setup actions and leaving the user in an appropriate directory (probably not the login 
directory). 


The system administrator often sets up a directory of commands (i.e., /usr/rbin) that can be safely invoked 
by rsh. Some systems also provide a restricted editor red. 


EXIT STATUS 


FILES 
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Errors detected by the shell, such as syntax errors, cause the shell to return a non-zero exit status. If the 
shell is being used non-interactively then execution of the shell file is abandoned. Otherwise, the shell 
returns the exit status of the last command executed (see also the exit command above). 


/etc/passwd 
/etc/profile 
$HOME/.profile 
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/tmp/sh* 
/dev/null 


SEE ALSO 
cat(1), cd(1), echo(1), emacs(1), env(1), gmacs(1), newgrp(1), test(1), umask(1), vi(1), dup(2), exec(2), 
fork(2), gtty(2), pipe(2), signal(2), umask(2), ulimit(2), wait(2), rand(3), a.out(5), profile(5), environ(7). 


CAVEATS 
If a command which 1s a tracked alias is executed, and then a command with the same name is installed in 
a directory in the search path before the directory where the original command was found, the shell will 
continue to exec the original command. Use the -t option of the alias command to correct this situation 


If you move the current directory or one above it, pwd may not give the correct response. Use the cd com- 
mand with a full path name to correct this situation. 


Some very old shell scripts contain a “ as a synonym for the pipe character |. 
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NAME 
lab — label maker 


SYNOPSIS 
lab [-—m ] [ name... ] 

DESCRIPTION 
Lab causes the named files to be queued for printing as mailing labels. If no files are named, the standard 
input is read. The option —m causes notification via mail(1) to be sent when the job completes. 


The last line of each label is identified by ending it with one or more spaces and a hyphen. The hyphen 
must be the last character in the line; no white space may follow it. 


FILES 
/ust/spool/lab/* spool area 
/usr/lib/lab printer daemon 
SEE ALSO 
pr(1) 
BUGS 


Queued jobs print in directory (seemingly random) order. 
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NAME 
last — report recent logins 


SYNOPSIS 
last [ userid ... ] [ terminal ] 


DESCRIPTION 
Last reports logins and logouts in reverse chronological order. Optional arguments restrict attention to 
selected userids or terminals. Terminals ‘tty0, ttyl, .... may be abbreviated ‘0, 1, ...’ 


Last reports userid, terminal, time on, and time off. A pseudo-user, ‘reboot’, logs in at reboots of the sys- 
tem, thus 


last reboot 
reports recent reboots. 


Upon interrupt, /ast tells how far back it has looked; upon quit (control-\) it tells how far and keeps on look- 
ing. 
FILES 
/ust/adm/wtmp login data base 
SEE ALSO 
who(1), wtmp(5), ac(8) 


BUGS 
Because the accounting file does not distinguish orderly shutdowns from crashes, neither does /ast. 
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NAME 
Icomp, Iprint — line-by-line profiler 
SYNOPSIS 
Icomp [options] ... file ... 
Iprint [options] [files] 
DESCRIPTION 
Lcomp is used in place of cc (1) or f77 (1) to insert instruction-counting code into programs. It recognizes 
options whose initial letters are taken from the string ‘‘cwpDUIRdINnz’’, and accepts files whose names 
end in ‘.c’, ‘.f’, ‘.s’, or ‘.o’. From each source file it derives a ‘.o’ file and a ‘.sL’ file which Iprint uses to 
correlate source lines with basic blocks. If the —-c option is not present it creates a.out. Each time the ‘a.out’ 
file is run statistics are added to a profiling file prof-out. 
Lprint produces on the standard output a listing (in the style of pr(1)) of the programs compiled by /comp. 
Without arguments or files, each line of the listing is preceded by the number of times it was executed, as 
determined from the data in prof-out. Lprint interprets the following options. 
-a Detailed listing of every machine instruction and how often it was executed. 
—-b Attempts to indicate how often each basic block was executed. 
-c Compress the prof. out file, which otherwise grows with every execution of a.out . 
-f Print summary information by function: instruction executions, number of invocations, source 
instructions, and number of instructions never executed. 
-i Before each line of source print the number of machine instructions executed. 
-p Before each line of source print the number of times the first basic block in that line was executed. 
-S Summarize the counts by source file: instruction exectuions, source instructions, instructions never 
executed, basic block executions, total number of source basic blocks, and how many were never 
executed. 
If any file names are given, the arguments "abip" apply only to them. If no options are given, —p is 
assumed. Any combination of options is allowed. 
FILES 
prof.out counts 
*.SL for correlating with source 
/ust/lib/bb finding basic blocks and inserting counting code 
/usr/lib/nexit.oprinting counts when ‘a.out’ exits 
SEE ALSO 
cc(1), £771) 
BUGS 


Page | 


A line in the source file may be in zero, one, or more basic blocks; the count given in the listing corre- 
sponds to some particular choice of the basic block to associate with the line. 
Processing the output of yacc(1) without removing ‘#line’ directives will produce unsatisfactory results. 


LD(1) 


NAME 
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Id — link editor 


SYNOPSIS 


Id [ option ] ... file ... 


DESCRIPTION 
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Ld combines several object programs into one, resolves external references, and searches libraries. In the 
simplest case several object files are given, and Jd combines them, producing an object module which can 
be either executed or become the input for a further /d run. (In the latter case, the -r option must be given 
to preserve the relocation bits.) The output of /d is left on a.out. This file is made executable only if no 
errors occurred during the load. 


The argument routines are concatenated in the order specified. The entry point of the output is the begin- 
ning of the first routine (unless the -e option is specified). 


If any argument is a library, it is searched exactly once at the point it is encountered in the argument list. 
Only those routines defining an unresolved external reference are loaded. If a routine from a library refer- 
ences another routine in the library, and the library has not been processed by ranlib (see ar(1)), the refer- 
enced routine must appear after the referencing routine in the library. Thus the order of programs within 
libraries may be important. The first member of a library should be a file named *__.SYMDEF’, which is 
understood to be a dictionary for the library as produced by ranlib(1); the dictionary is searched iteratively 
to satisfy as many references as possible. 


‘ > 6 


The symbols ‘ etext’, ‘ edata’ and ‘_ end’ (‘etext’, ‘edata’ and ‘end’ in C) are reserved, and if referred to, 
are set to the first location above the program, the first location above initialized data, and the first location 
above all data respectively. It is erroneous to define these symbols. 


Ld understands several options. Except for -I, they should appear before the file names. 


-A This option specifies incremental loading, i.e. linking is to be done in a manner so that the result- 
ing object may be read into an already executing program. The next argument is the name of a file 
whose symbol table will be taken as a basis on which to define additional symbols. Only newly 
linked material will be entered into the text and data portions of a.out, but the new symbol table 
will reflect every symbol defined before and after the incremental load. This argument must 
appear before any other object file in the argument list. The -T option may be used as well, and 
will be taken to mean that the newly linked segment will commence at the corresponding address 
(which must be a multiple of 1024). The default value is the old value of _end. 


-D Take the next argument as a hexadecimal number and pad the data segment with zero bytes to the 
indicated length. 


-d Force definition of common storage even if the -r flag is present. 


-e The following argument is taken to be the name of the entry point of the loaded program; location 
0 is the default. 


lx This option is an abbreviation for the library name ‘/lib/libx.a’, where x is a string. If that does not 
exist, /d tries ‘/usr/lib/libx.a’ A library is searched when its name is encountered, so the placement 
of a -l is significant. 


—-M produce a primitive load map, listing the names of the files which will be loaded. 
—-N Do not make the text portion read only or sharable. (Use "magic number" 0407.) 
—n Arrange (by giving the output file a 0410 "magic number") that when the output file is executed, 


the text portion will be read-only and shared among all users executing the file. This involves 
moving the data areas up to the first possible 1024 byte boundary following the end of the text. 


-0 The name argument after —-o is used as the name of the /d output file, instead of a.out. 


—r Generate relocation bits in the output file so that it can be the subject of another /d run. This flag 
also prevents final definitions from being given to common symbols, and suppresses the 
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‘undefined symbol’ diagnostics. 

-S ‘Strip’ the output by removing all symbols except locals and globals. 

-s ‘Strip’ the output, that is, remove the symbol table and relocation bits to save space (but impair the 
usefulness of the debuggers). This information can also be removed by strip (1). 

-T The next argument is a hexadecimal number which sets the text segment origin. The default origin 
is 0. 

-t (‘trace’) Print the name of each file as it is processed. 

-u Take the following argument as a symbol and enter it as undefined in the symbol table. This is 
useful for loading wholly from a library, since initially the symbol table is empty and an unre- 
solved reference is needed to force the loading of the first routine. 

-X Save local symbols except for those whose names begin with “L’. This option is used by cc(1) to 
discard internally-generated labels while retaining symbols local to routines. 

-x Do not preserve local (non-.globl) symbols in the output symbol table; only enter external sym- 
bols. This option saves some space in the output file. 

-ysym Indicate each file in which sym appears, its type and whether the file defines or references it. Many 
such options may be given to trace many symbols. (It is usually necessary to begin sym with an 
* ’, as external C, FORTRAN and Pascal variables begin with underscores.) 

-Z Arrange for the process to be loaded on demand from the resulting executable file (413 format) 
rather than preloaded. This is the default. Results in a 1024 byte header on the output file fol- 
lowed by a text and data segment each of which have size a multiple of 1024 bytes (being padded 
out with nulls in the file if necessary). With this format the first few BSS segment symbols may 
actually appear (from the output of size(1)) to live in the data segment; this to avoid wasting the 
space resulting from data segment size roundup. 

FILES 

Nib/lib*.a libraries 

/usr/lib/lib*.a more libraries 

/usr/local/lib/lib*.a_ still more libraries 

a.out output file 

SEE ALSO 
as(1), ar(1), cc(1), ranlib(1), size(1), nm(1) 
BUGS 


There is no way to force data to be page aligned. 
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NAME 


learn — computer aided instruction about UNIX 


SYNOPSIS 


learn [ -directory ] [ subject [ lesson [ speed ] ] ] 


DESCRIPTION 


FILES 


BUGS 
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Learn gives CAI courses and practice in the use of UNIX. To get started simply type ‘learn’. The program 
will ask questions to find out what you want to do. The questions may be bypassed by naming a subject, 
and the last Jesson number that /earn told you in the previous session. You may also include a speed num- 
ber that was given with the lesson number (but without the parentheses that /earn places around the speed 
number). If /esson is ‘“—’, learn prompts for each lesson; this is useful for debugging. 


The subjects presently handled are 


editor 
eqn 

files 
macros 
morefiles 
C 


The special command ‘bye’ terminates a /earn session. 


The —directory option allows one to exercise a script in a nonstandard place. 


/usr/learn and all dependent directories and files 


The main strength of learn, that it asks the student to use the real UNIX, also makes possible baffling mis- 
takes. It is helpful, especially for nonprogrammers, to have a UNIX initiate near at hand during the first 
sessions. 


Occasionally lessons are incorrect, sometimes because the local version of a command operates in a non- 
standard way. Such lessons may be skipped, but it takes some sophistication to recognize the situation. 
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NAME 
lex — generator of lexical analysis programs 


SYNOPSIS 
lex [ -tvfn ] [ file ] ... 


DESCRIPTION 
Lex generates programs to be used in simple lexical analyis of text. The input files (standard input default) 
contain regular expressions to be searched for, and actions written in C to be executed when expressions are 
found. 


AC source program, ‘lex.yy.c’ is generated, to be compiled thus: 
cc lex.yy.c —ll 


This program, when run, copies unrecognized portions of the input to the output, and executes the associ- 
ated C action for each regular expression that is recognized. 


The following /ex program converts upper case to lower, removes blanks at the end of lines, and replaces 
multiple blanks by single blanks. 


%% 
[A—Z] putchar(yytext[0]+’a—“A’); 
[ ]+$ 

[]+  putchar(’ ’); 


The options have the following meanings. 


-t Place the result on the standard output instead of in file ‘lex.yy.c’. 

-V Print a one-line summary of statistics of the generated analyzer. 

—n Opposite of —v; —n is default. 

-f ‘Faster’ compilation: don’t bother to pack the resulting tables; limited to small programs. 
SEE ALSO 


yacc(1), sed(1) 
M. E. Lesk and E. Schmidt, LEX — Lexical Analyzer Generator 
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NAME 
lint — a C program verifier 


SYNOPSIS 
lint [ -abchnpuyx ] file ... 


DESCRIPTION 
Lint attempts to detect features of the C program files which are likely to be bugs, or non-portable, or waste- 
ful. It also checks the type usage of the program more strictly than the compilers. Among the things which 
are currently found are unreachable statements, loops not entered at the top, automatic variables declared 
and not used, and logical expressions whose value is constant. Moreover, the usage of functions is checked 
to find functions which return values in some places and not in others, functions called with varying num- 
bers of arguments, and functions whose values are not used. 


By default, it is assumed that all the files are to be loaded together; they are checked for mutual compatibil- 
ity. Function definitions for certain libraries are available to lint; these libraries are referred to by a conven- 
tional name, such as ‘lm’, in the style of /d(1). 


Any number of the options in the following list may be used. The -D, -U, and -I options of cc(1) are also 
recognized as separate arguments. 


p Attempt to check portability to the JBM and GCOS dialects of C. 
h Apply a number of heuristic tests to attempt to intuit bugs, improve style, and reduce waste. 
b Report break statements that cannot be reached. (This is not the default because, unfortunately, 


most /ex and many yacc outputs produce dozens of such comments.) 


v Suppress complaints about unused arguments in functions. 

x Report variables referred to by extern declarations, but never used. 

a Report assignments of long values to int variables. 

c Complain about casts which have questionable portability. 

u Do not complain about functions and variables used and not defined, or defined and not used (this 


is suitable for running /int on a subset of files out of a larger program). 
n Do not check compatibility against the standard library. 
Exit(2) and other functions which do not return are not understood; this causes various lies. 
Certain conventional comments in the C source will change the behavior of lint: 


/* NOTREACHED*/ 
at appropriate points stops comments about unreachable code. 


/*V ARARGSn#/ 
suppresses the usual checking for variable numbers of arguments in the following function decla- 
ration. The data types of the first n arguments are checked; a missing n is taken to be 0. 


/*PRINTFLIKEn */ 
The data types of the first n arguments are checked as usual. The remaining arguments are 
checked against the n’th argument which is interpreted as a printf(3) format string. 


/*SCANFLIKEn */ 
Similarly for scanf(3). 
/*NOSTRICT*#/ 


shuts off strict type checking in the next expression. 


/* ARGSUSED*/ 
turns on the —v option for the next function. 


/*LINTLIBRARY*/ 
at the beginning of a file shuts off complaints about unused functions in this file. 
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FILES 
/usr/lib/lint/lint[12] programs 
/usr/lib/lint/Ilib-Ic declarations for standard functions 
/usr/lib/lint/llib-port declarations for portable functions 


SEE ALSO 
cc(1), cyntax(1) 
S.C. Johnson, Lint, a C Program Checker 
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NAME 

lisp, liszt, xref — lisp interpreter and compiler 
SYNOPSIS 

lisp 


liszt [ option ... ] [ source ] 


Ixref [ —n ] file... 


DESCRIPTION 


FILES 


Lisp interprets Franz Lisp, which closely resembles MIT’s Maclisp. Interpreted functions may be mixed 
with code compiled by /iszt, and both may be debugged using the ‘Joseph Lister’ trace package. 


There are too many functions to list here; one should refer to the manuals listed below. 


Liszt compiles the lisp source file, whose name ends in .1, into an object file, whose name ends in .o. The 
following options are available. 


-w suppress warning diagnostics 
-q suppress compilation statistics 
-0 object 


put object code in specified file 

—m source is Maclisp 

-u source is UCI Lisp 

-S leave assembler input in file suffixed .s; do not finish compilation 

-x place cross-reference list in file suffixed .x to be used by /xref. 

Liszt with no arguments is the same as lisp. The compiler may be invoked from the interpreter: 
( liszt [options] foo) 

compiles file ‘foo.!’. 


Lxref writes to the standard output a readable form of the named cross-reference files. Not more than n 
(default 50) references to any function will be printed. 


/usr/lib/lisp/auxfns0.1_ common functions 
/usr/lib/lisp/auxfns1.1 less common functions 
/usr/lib/lisp/trace.1 Joseph Lister trace package 
/usr/lib/lisp/toplevel.l top level read-eval-print loop 
/usr/lib/lisp/machacks.1 Maclisp compatibility package 
/usr/lib/list/ucifne.1 UCI Lisp compatibility package 


SEE ALSO 


BUGS 
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‘FRANZ Lisp Manual, Version 1’ by John K. Foderaro 
MACLIsP Manual 


The error system is in a state of flux and not all error messages are as informative as they could be. 
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NAME 
In — make links 


SYNOPSIS 
In [-s ] namel [ name2 ] 
In name ... directory 


DESCRIPTION 
A link is a directory entry referring to a file; the same file (together with its size, all its protection informa- 
tion, etc.) may have several links to it. There are two kinds of links: hard links and symbolic links. 


By default Jn makes hard links. A hard link to a file is indistinguishable from the original directory entry; 
changes to the file are effective regardless of the name used to reference the file. Hard links may not span 
file systems and may not refer to directories. 


The -s option makes symbolic links. A symbolic link contains the name of the file to which it is linked. 
Except in special cases, such as rm(1), unlink(2), lstat, and readlink, the contents of a symbolic link is 
taken as the pathname of the file. Symbolic links may span file systems and may refer to directories. 


Given one or two nondirectory arguments, the second not being a directory, /n makes a link to an existing 
file namel. If name2 is given, the link has that name, otherwise name2 is understood to be the same as the 
last component of name/. 


Given two or more arguments, the last being a directory, /n makes therein links to all the named files. 


SEE ALSO 
rm(1), cp(1), mv(1), link(2), stat(2) 
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NAME 
look — find lines in a sorted list 
SYNOPSIS 
look [ -dfnixtc ] [ string ] [ file ] 
DESCRIPTION 
Look consults a sorted file and prints all lines that begin with string. It uses binary search. 
The following options are recognized. Options dfntc affect comparisons as in sort(1). 
i Interactive. There is no string argument; instead /ook takes lines from the standard input as strings 
to be looked up. 
x Exact. Print only lines of the file whose key matches string exactly. 
d ‘Dictionary’ order: only letters, digits, tabs and blanks participate in comparisons. 
f Fold. Upper case letters compare equal to lower case. 
n Numeric comparison with initial string of digits, optional minus sign, and optional decimal point. 
tc “Tab character’ c terminates the sort key in the file. 
If no file is specified, /usr/dict/words is assumed, with collating sequence df. 
FILES 
/usr/dict/words 
SEE ALSO 
sort(1), grep(1), dict(7) 
DIAGNOSTICS 


Look returns exit status 0 if string is found, 1 if not found, 2 for error. 
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NAME 

Ipr— line printer spooler 
SYNOPSIS 

Ipr [-m ] [ name ... ] 

Ip0 [ name ... ] 

Ip1 [ name ... ] 
DESCRIPTION 


Lpr causes the named files to be queued for printing. If no files are named, the standard input is read. The 
option -m causes notification via mail(1) to be sent when the job completes. 


Lp0 and Ip/ direct output to particular printers. 


FILES 

/ust/spool/lpd/* spool area 

/usr/lib/lpd printer daemon 

/usr/lib/\pf filter to handle banners and underlining 
SEE ALSO 

pr(1) 
BUGS 


Queued jobs print in directory (seemingly random) order. 
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ls — list contents of directory 


SYNOPSIS 


Is [ -abcdfilqrstul1CFLR ] name ... 


DESCRIPTION 
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For each directory argument, /s lists the contents of the directory; for each file argument, /s repeats its name 
and any other information requested. The output is sorted alphabetically by default. When no argument is 
given, the current directory is listed. When several arguments are given, the arguments are first sorted 
appropriately, but file arguments appear before directories and their contents. 


Output to a terminal is normally listed in multiple columns. If the standard output is not a terminal, the 
default format is to list one entry per line. 


There are an unbelievable number of options: 


-l List in long format, giving mode (see below), number of links, owner, group, size in bytes, and 
time of last modification for each file. Symbolic links are identified by a link count marked ‘L’; 
the link count is that of the ultimate file. If the file is a special file the size field will instead con- 
tain the major and minor device numbers. 


-t Sort by time modified (latest first) instead of by name, as is normal. 

-a List all entries; usually ‘.’ and “..’ are suppressed. 

-s Give size in kilobytes (kilo=1024) for each entry. 

-d If argument is a directory, list its name, not its contents. 

-r Reverse the order of sort to get reverse alphabetic or oldest first as appropriate. 

-u Under -t sort by time of last access; under -I give access time. 

-c Under -t sort by time of inode change; under -] give inode change time. 

-i Print i-number in first column of the report for each file listed. 

-L Under -1 for each symbolic link give the immediate, not the ultimate, link count and append the 


name pointed to. 


-f Force each argument to be interpreted as a directory and list the name found in each slot. This 
option turns off 41, -t, -s, and -r, and turns on —a; the order is the order in which entries appear in 
the directory. 


-1 force one entry per line output format, e.g. to a teletype 
-C force multi-column output, e.g. to a file or a pipe 
-q force printing of non-graphic characters in file names as the character ‘?’; this normally happens 


only if the output device is a teletype 


-F cause directories to be marked with a trailing ‘/ and executable files to be marked with a trailing 
6%? 
-R recursively list subdirectories encountered. 


The mode printed under the -] option contains 11 characters which are interpreted as follows: the first char- 
acter is 


d if the entry is a directory; 
b if the entry is a block-type special file; 
c if the entry is a character-type special file; 


- if the entry is a plain file. 


The next 9 characters are interpreted as three sets of three bits each. The first set refers to owner permis- 
sions; the next to permissions to others in the same user-group; and the last to all others. Within each set 
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FILES 


BUGS 
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the three characters indicate permission respectively to read, to write, or to execute the file as a program. 
For a directory, ‘execute’ permission is interpreted to mean permission to search the directory for a 
specified file. The permissions are indicated as follows: 


if the file is readable; 

if the file is writable; 

if the file is executable; 

— if the indicated permission is not granted. 


xeon" 


The group-execute permission character is given as s if the file has set-group-ID mode; likewise the user- 
execute permission character is given as Ss if the file has set-user-ID mode. 


The last character of the mode (normally ‘x’ or ‘—’) is t if the 1000 bit of the mode is on. See chmod(1) for 
the meaning of this mode. 


When the sizes of the files in a directory are listed, a total count of blocks is printed. 
/etc/passwd, /etc/group to get ID’s for ‘Is -I’. 


The output device is assumed to be 80 columns wide. 

The option setting based on whether the output is a teletype is undesirable as ‘Is -s’ behaves differently 
from ‘Is—s | Ipr’. On the other hand, not doing this setting would make many shell scripts which use /s 
almost certain losers. 

Option -s counts unwritten holes as if they were real data. 
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NAME 


Eighth Edition M4(1) 


m4 — macro processor 


SYNOPSIS 


m4 [ options ] [ files ] 


DESCRIPTION 
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M4 is a macro processor intended as a front end for Ratfor, C, and other languages. Each of the argument 
files is processed in order; if there are no files, or if a file name is —, the standard input is read. The pro- 
cessed text is written on the standard output. 


The options and their effects are as follows: 


-e Operate interactively. Interrupts are ignored and the output is unbuffered. Using this mode 
requires a special state of mind. 


-s Enable line sync output for the C preprocessor (#line ... ) 
-Bint Change the size of the push-back and argument collection buffers from the default of 4,096. 
-Hint Change the size of the symbol table hash array from the default of 199. The size should be prime. 


-Sint Change the size of the call stack from the default of 100 slots. Macros take three slots, and non- 
macro arguments take one. 


-Tint Change the size of the token buffer from the default of 512 bytes. 
To be effective, these flags must appear before any file names and before any —D or -U flags: 


—Dname [=val] 
Defines name to val or to null in val’s absence. 


—Uname 
undefines name. 


Macro calls have the form: 
name(arg1,arg2, ..., argn) 


The ( must immediately follow the name of the macro. If a defined macro name is not followed by a ( it is 
deemed to have no arguments. Leading unquoted blanks, tabs, and new-lines are ignored while collecting 
arguments. Potential macro names consist of alphabetic letters, digits, and underscore _, where the first 
character is not a digit. 


Left and right single quotes are used to quote strings. The value of a quoted string is the string stripped of 
the quotes. 


When a macro name is recognized, its arguments are collected by searching for a matching right parenthe- 
sis. Macro evaluation proceeds normally during the collection of the arguments, and any commas or right 
parentheses which happen to turn up within the value of a nested call are as effective as those in the original 
input text. After argument collection, the value of the macro is pushed back onto the input stream and res- 
canned. 


M4 makes available the following built-in macros. They may be redefined, but once this is done the origi- 
nal meaning is lost. Their values are null unless otherwise stated. 


define the second argument is installed as the value of the macro whose name is the first argument. 
Each occurrence of $n in the replacement text, where n is a digit, is replaced by the n-th 
argument. Argument 0 is the name of the macro; missing arguments are replaced by the null 
string; $# is replaced by the number of arguments; $* is replaced by a list of all the argu- 
ments separated by commas; $@ is like $*, but each argument is quoted (with the current 
quotes). 


undefine removes the definition of the macro named in its argument. 


M4(1) 


defn 


pushdef 
popdef 
ifdef 


shift 


changequote 


changecom 


divert 


undivert 


divnum 
dnl 


ifelse 


incr 


decr 


eval 


len 


index 


substr 


translit 
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returns the quoted definition of its argument(s). It is useful for renaming macros, especially 
built-ins. 


like define, but saves any previous definition. 
removes current definition of its argument(s), exposing the previous one if any. 


if the first argument is defined, the value is the second argument, otherwise the third. If 
there is no third argument, the value is null. The word unix is predefined on UNIX versions 
of m4. 


returns all but its first argument. The other arguments are quoted and pushed back with 
commas in between. The quoting nullifies the effect of the extra scan that will subsequently 
be performed. 


change quote symbols to the first and second arguments. The symbols may be up to five 
characters long. Changequote without arguments restores the original values (i.e., s 7). 


change left and right comment markers from the default # and new-line. With no arguments, 
the comment mechanism is effectively disabled. With one argument, the left marker 
becomes the argument and the right marker becomes new-line. With two arguments, both 
markers are affected. Comment markers may be up to five characters long. 


m4 maintains 10 output streams, numbered 0-9. The final output is the concatenation of the 
streams in numerical order; initially stream 0 is the current stream. The divert macro 
changes the current output stream to its (digit-string) argument. Output diverted to a stream 
other than 0 through 9 is discarded. 


causes immediate output of text from diversions named as arguments, or all diversions if no 
argument. Text may be undiverted into another diversion. Undiverting discards the diverted 
text. 


returns the value of the current output stream. 
reads and discards characters up to and including the next new-line. 


has three or more arguments. If the first argument is the same string as the second, then the 
value is the third argument. If not, and if there are more than four arguments, the process is 
repeated with arguments 4, 5, 6 and 7. Otherwise, the value is either the fourth string, or, if 
it is not present, null. 


returns the value of its argument incremented by 1. The value of the argument is calculated 
by interpreting an initial digit-string as a decimal number. 


returns the value of its argument decremented by 1. 


evaluates its argument as an arithmetic expression, using 32-bit arithmetic. Operators 
include +, -, *, /, %, ~ (exponentiation), bitwise &, |, *, and ~; relationals; parentheses. 
Octal and hex numbers may be specified as in C. The second argument specifies the radix 
for the result; the default is 10. The third argument may be used to specify the minimum 
number of digits in the result. 


returns the number of characters in its argument. 


returns the position in its first argument where the second argument begins (zero origin), or 
—1 if the second argument does not occur. 


returns a substring of its first argument. The second argument is a zero origin number select- 
ing the first character; the third argument indicates the length of the substring. A missing 
third argument is taken to be large enough to extend to the end of the first string. 


transliterates the characters in its first argument from the set given by the second argument to 
the set given by the third. No abbreviations are permitted. 
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include 
sinclude 
syscmd 
sysval 
maketemp 
m4exit 
m4wrap 
errprint 


dumpdef 


traceon 


traceoff 


SEE ALSO 
The M4 Macro Processor by B. W. Kernighan and D. M. Ritchie. 
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returns the contents of the file named in the argument. 

is identical to include, except that it says nothing if the file is inaccessible. 

executes the UNIX command given in the first argument. No value is returned. 

is the return code from the last call to syscmd. 

fills in a string of XXXXX in its argument with the current process ID. 

causes immediate exit from m4. Argument 1, if given, is the exit code; the default is 0. 
argument | will be pushed back at final EOF; example: m4wrap(* cleanup() ~) 

prints its argument on the diagnostic output file. 


prints current names and definitions, for the named items, or for all if no arguments are 
given. 

with no arguments, turns on tracing for all macros (including built-ins). Otherwise, turns on 
tracing for named macros. 


turns off trace globally and for any macros specified. Macros specifically traced by traceon 
can be untraced only by specific calls to traceoff. 
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NAME 


mail — send or receive mail 


SYNOPSIS 


mail [-r ][-p][-m] [-f file ] 
mail person ... 
mail —n 


DESCRIPTION 
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Mail with no argument prints a user’s mail, message-by-message, in last-in, first-out order, prompting 
between messages. The options are: 


-r Print mail in first-in, first-out order. 
-p Print entire mailbox without pause between messages. 
—m Only print messages explicitly requested by the user. 


-ffile Use file, e.g. ‘mbox’, as if it were the mailbox. 


After printing a prompt mail reads a line from the standard input to direct disposition of the message. Com- 
mands are of the form ‘[range] command [arguments]’. The command is applied to each message in the 
specified range. The optional range can be: 

current message 


+ next message 
- previous message 
a number 


the correspondingly numbered message 
number 1 ,number2 
the range of messages between number! and number? inclusive 


The commands are: 


d Mark message for deletion on exiting mail. 

u remove mark for deletion. 

h Print the disposition, size in characters, and header line for each message in the mailbox. 

p Print message. 

s[file ]... 
Save the message in the named files (‘mbox’ default, in HOME directory if known, see 
environ(5)). 


m[ person ]... 

Mail the message to the named persons (yourself by default). 
r Reply to the sender of the last message printed. 
EOT (control-D) 

Put unexamined mail back in the mailbox and stop. 


q Same as EOT. 
x Exit, without changing the mailbox file. 
!command 
Escape to the Shell to do command. 
? Print a command summary. 


= Print the number of the current message. 
An interrupt stops the printing of the current letter. 


When persons are named, mail takes the standard input up to an end-of-file, or to a line consisting of a sin- 
gle ‘.’. and adds it to each person’s mailbox. The message is automatically postmarked with the sender’s 
name and date. Lines that look like postmarks are prefixed with ‘>’. 


Person is usually a login name. To denote a recipient on a remote system, a network name must be used 
instead of a simple login name; see uucp(1), mail(7). 


If a person’s mailbox contains the sole line 
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FILES 


Forward to name 
the mail is sent to name instead of person. Name may be a list of names. 
If a person’s mailbox contains the sole line 

Pipe to command 


the mail is piped to command instead of being appended to person’s mailbox. The command is run with 
the user and group id of the mailbox’s owner. 


Each user owns his own mailbox, which is by default generally readable but not writable. Mail does not 
delete an empty mailbox nor change its mode, so a user may make it unreadable if desired. 


Option —n causes notice to be given on your terminal whenever mail is delivered to your mail box. The 
option is reversed at each occurrence. See also sysmon(9.1) and the MAIL variable of sh(1). 


When a user logs in he is informed of the presence of mail. 


/usr/spool/mail/mail.log mail log file 


/usr/spool/mail/* mailboxes 

/etc/passwd to identify sender and locate persons 
mbox saved mail 

/tmp/ma* temp file 


$HOME/dead letter unmailable text 
/usr/lib/upas/printmail the program to peruse the mail 
uux(1) 


SEE ALSO 


BUGS 


xsend(1), write(1), sysmon(9.1), uucp(1), mail(7), upas(8) 


Option —n doesn’t work in a mux(9.1) layer. 
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NAME 

Mail — send and receive mail 
SYNOPSIS 

Mail [ option ] ... [ person ] ... 
DESCRIPTION 


Mail with persons named reads a letter from the standard input and sends it to them. 


Mail otherwise presents your mail. It responds to commands, each typed on a line by itself, possibly with 
arguments. A command need not be typed in its entirety — the first command that matches the typed prefix 
is used. A missing message list is interpreted as a singleton: whichever of the current message, the nearest 
message ahead, or the nearest message back satisfies the command’s requirements. 


The following table describes the commands: 


Command Description 
! Single command escape to shell 


Reply 
alias 


Back up to previous message 
Reply to author of message only 
Define an alias as a set of user names 


alternates List other names you are known by 
chdir Change working directory, home by default 


copy Copy a message to a file or folder 

delete Delete a list of messages 

dt Delete current message, type next message 
endif End of conditional statement; see if 

edit Edit a list of messages 

else Start of else part of conditional; see if 

exit Leave mail without changing anything 

file Interrogate/change current mail file 


folder Same as file 
folders _List the folders in your folder directory 


from List headers of a list of messages 

headers List current window of messages 

help Print brief summary of Mail commands 

hold Same as preserve 

if Conditional execution of Mail commands 
ignore Do not print listed headers 

mail Send mail to specified names 

mbox Arrange to save a list of messages in mbox 
next Go to next message and type it 

preserve Arrange to leave list of messages in mbox 
quit Leave Mail; update mbox as appropriate 
reply Compose a reply to a message 

save Append messages, headers included, on a file 
set Set binary or valued options 

shell Invoke an interactive shell 

top Print first so many (5 by default) lines of list of messages 
type Print messages 

undelete Undelete list of messages 

unset Undo the operation of a set 

visual Invoke visual editor on a list of messages 
write Append messages to a file, don’t include headers 
Z Scroll to next/previous screenful of headers 
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The following table describes the options for set. Each option is shown as being either a binary or valued 


option. 


Option Type Description 
EDITOR valued Pathname of editor for ~e and edit 
SHELL ~ valued Pathname of shell for shell, ~! and! 


VISUAL valued Pathname of screen editor for ~v, visual 
append __ binary Always append messages to end of mbox 

ask binary Prompt user for Subject: field when sending 
askcc binary Prompt user for additional Cc’s at end of message 
autoprint binary Print next message after delete 

crt valued Minimum number of lines before using more 
dot binary Accept . alone on line to terminate message input 
escape valued Escape character to be used instead of ~ 

folder valued Directory to store folders in 

hold binary Hold messages in mbox by default 

ignore binary Ignore RUBOUT while sending mail 

ignoreeof binary Don’t terminate letters/command input with *D 
keep binary Don’t unlink mbox when empty 

keepsave binary Don’t delete saved messages by default 

metoo binary Include sending user in aliases 

nosave _ binary Don’t save partial letter in dead.letter 

quiet binary Suppress printing of Mail version 

record valued File to save all outgoing mail in 

screen valued Size of window of message headers for z, etc. 
sendmail valued Choose alternate mail delivery system 

toplines valued Number of lines to print in top 


The following table summarizes tilde escapes available while entering a letter. 


Escape Arguments Description 
! command Execute shell command 


a 


Cc name ... Add names to Cc: field 

“d Read dead. letter into message 

“e Invoke text editor on partial message 
“f messages Read named messages 

h Edit the header fields 

“m messages Read named messages, right shift by tab 
=) Print message entered so far 

“q Abort entry of letter; like RUBOUT 

a: filename _ Read file into message 

“s string Set Subject: field to string 

t name ... Add names to To: field 

“v Invoke screen editor on message 

sy filename Write message on file 


a 


command Pipe message through command 
string Quote a~ in front of string 


i 


The following table shows the command line flags. 


Flag Description 

—N Suppress the initial printing of headers 

-T file Article-id’s of read/deleted messages to file 
-d Turn on debugging 


-f file Show messages in file or SHOME/mbox 
—h number Pass on hop count for mail forwarding 
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4 Ignore tty interrupt signals 

—n Inhibit reading of /usr/lib/Mail.rc 
—tname_ Pass on name for mail forwarding 

-s string Use string as subject in outgoing mail 
—uname Read name’s mail instead of your own 


Notes: -T , -d , -h, and -r are not fit for human consumption. 


FILES 
/usr/spool/mail/* post office 
$HOME/mbox your old mail 
$HOME/.mailre file giving initial mail commands 
/tmp/R# temporary for editor escape 
/usr/lib/Mail.help* help files 
/asr/lib/Mail.rc system initialization file 
/bin/mail to do actual mailing 

SEE ALSO 
mail(1) 
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NAME 


make — maintain collections of programs 


SYNOPSIS 


make [ -f makefile ] [ option ] ... [ name ] ... 


DESCRIPTION 
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Make executes commands in makefile to update the target names (usually programs). If no target is 
specified, the targets of the first rule in makefile are updated. If no -f option is present, ‘makefile’ and 
‘Makefile’ are tried in order. If makefile is ‘—’, the standard input is taken. More than one -f option may 
appear. 


Make updates a target if it depends on prerequisite files that have been modified since the target was last 
modified, or if the target does not exist. The prerequisites are updated before the target. 


The makefile comprises a sequence of rules and macro definitions. The first line of a rule is a blank- 
separated list of targets, then a single or double colon, then a list of prerequisite files terminated by semi- 
colon or newline. Text following a semicolon, and all following lines that begin with a tab, are shell com- 
mands to be executed to update the target. 


If a name appears as target in more than one single-colon rule, it depends on all of the prerequisites of those 
rules, but only one command sequence may be specified among the rules. A target in a double-colon rule is 
updated by the following command sequence only if it is out of date with respect to the prerequisites of that 
tule. 


Two special forms of name are recognized. A name like a(b) means the file named 5 stored in the archive 
named a. A name like a((b)) means the file stored in archive a and containing the entry point b. 


Sharp and newline surround comments. 


In this makefile ‘pgm’ depends on two files ‘a.o’ and ‘b.o’, and they in turn depend on ‘.c’ files and a com- 
mon file ‘ab.h’: 


pgm: a.o b.o 

cc a.o b.o —Iplot —o pgm 
a.o: ab.h a.c 

cc -C a.c 
b.o: ab.h b.c 

cc —c b.c 


Makefile lines of the form 
string] = string2 


are macro definitions. Subsequent appearances of $(string/) are replaced by string2. If string/ is a single 
character, the parentheses are optional. Each entry in the environment (see sh(1)) of the make command is 
taken as a macro definition, as are command arguments with embedded equal signs. 


A target containing a single ‘%’ introduces a pattern rule, which controls the making of names that do not 
occur explicitly as targets. The ‘%’ matches an arbitrary string called the stem: A%B matches any string 
that begins with A and ends with B. A ‘%’ in a prerequisite name stands for the stem; and the special 
macro ‘$%’ stands for the stem in the construction commands. A name that has no explicit rule is matched 
against the target of each pattern rule. The first pattern rule for which the prerequisites exist specifies fur- 
ther dependencies. 


This pattern rule maintains an object library where all the C source files share a common include file 
‘defs.h’. The macro ‘CFLAGS’ sets compiler options. 


arch.a(%.o) : %.c defs.h 
cc $(CFLAGS) -c $%.c 
ar r arch.a $%.o 
rm $%.0 
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A set of default pattern rules is built in, and effectively follows the user’s list of rules. Assuming these 
rules, which tell, among other things, how to make ‘.o’ files from ‘.c’ files, the first example becomes: 


pgm: a.o b.o 
cc a.o b.o —Iplot —o pgm 
a.o b.o: ab.h 
Here, greatly simplified, is a sample of the built-in rules: 
CC = cc 
%.0: Yo.c 
$(CC) $(CFLAGS) -c $%.c 
%.0: Gof 
£77 $(FFLAGS) —c $%.f 
Yo: Toc 


$(CC) $(CFLAGS) -0 $% $%.c 


The first rule says that a name ending in ‘.o’ could be made if a matching name ending in ‘.c’ were present. 
The second states a similar rule for files ending in ‘.f. The third says that an arbitrary name can be made 
by compiling a file with that name suffixed by ‘.c’. 


Macros make the builtin pattern rules flexible: CC names the particular C compiler, CFLAGS gives cc(1) 
options, FFLAGS for f77(1), LFLAGS for lex(1), YFLAGS for yacc(1), and PFLAGS for pascal(1). 


An older, now disparaged, means of specifying default rules is based only on suffixes. Prerequisites are 
inferred according to selected suffixes listed as the ‘prerequisites’ for the special name *.SUFFIXES’; mul- 
tiple lists accumulate; an empty list clears what came before. 


The rule to create a file with suffix s2 that depends on a similarly named file with suffix s/ is specified as an 
entry for the ‘target’ s/s2. Order is significant; the first possible name for which both a file and a rule exist 
is inferred. An old style rule for making optimized ‘.o’ files from ‘.c’ files is 

.c.0: ; cc C—O -0 $@ $#.c 


The following two macros are defined for use in any rule: 
$($@) full name of target 
$($/) target name beginning at the last slash, if any 


A number of other special macros are defined automatically in rules invoked by one of the implicit mecha- 


nisms: 

$x target name with suffix deleted 

$@ full target name 

$< list of prerequisites in an implicit rule 
$? list of prerequisites that are out of date 
$* list of all prerequisites 


The following are included for consistency with System V: 
$(@D) directory part of $@ (up to last slash) 

$(@F) file name part of $@ (after last slash) 

$(*D) directory part of $* (up to last slash) 

$(*F) file name part of $* (after last slash) 

$(<D)_ directory part of $< (up to last slash) 

$(<F) file name part of $< (after last slash) 


Command lines are executed one at a time, each by its own shell. A line is printed when it is executed 
unless the special target ‘.SILENT” is in the makefile, or the first character of the command is ‘@’. 


Commands returning nonzero status (see intro(1)) cause make to terminate unless the special target 
“ IGNORE’ is in the makefile or the command begins with <tab><hyphen>. 


Interrupt and quit cause the target to be deleted unless the target depends on the special name ‘.PRE- 
CIOUS’. 
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Make includes a rudimentary parallel processing ability. If the separation string is ‘:&’ or ‘::&’, make can 
run the command sequences to create the prerequisites simultaneously. If two names are separated by an 
ampersand on the right side of a colon, those two may be created in parallel. 


Other options: 


-i 


-k 


—n 


Equivalent to the special entry “ IGNORE: ’. 


When a command returns nonzero status, abandon work on the current entry, but continue on 
branches that do not depend on the current entry. 


Trace and print, but do not execute the commands needed to update the targets. 
Touch, i.e. update the modified date of targets, without executing any commands. 
Equivalent to an initial special entry ‘.SUFFIXES:’ with no list. 

Equivalent to the special entry ‘“.SILENT:’. 


Environment definitions override conflicting definitions in arguments or in makefiles. Ordinary 
precedence is argument over makefile over environment. 


Assume old style default suffix list: SUFFIXES: .out .o .c.e .r.f.y .1.s.p 


Permit n command sequences to be done in parallel with ‘&’. 


makefile, Makefile 


SEE ALSO 
sh(1), touch(1), ar(1) 
S. I. Feldman Make — A Program for Maintaining Computer Programs 
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NAME 

man — print sections of this manual 
SYNOPSIS 

man [ option ... ] [ chapter ] title ... 
DESCRIPTION 


Man locates and prints the section of this manual named title in the specified chapter. (In this context, the 
word ‘page’ is often used as a synonym for ‘section’.) The title is entered in lower case. The chapter num- 
ber does not have a letter suffix. If no chapter is specified, the whole manual is searched for title and all 
occurrences of it are printed. 


Options and their meanings are: 


-q Copy an already formatted manual section to the terminal or, if none is available, act as -n. If the 
standard output is a terminal, underline(1) the output. This is the default option. 


-t Place typesetting instructions on the standard output using troff(1). 
—n Print the section on the standard output using nroff. 
-w Print the path names of the manual sections, but do not print the sections themselves. 


Further options, e.g. to specify the kind of terminal you have, are passed on to troff(1) or nroff. Options 
and chapter may be changed before each title. 


EXAMPLE 
man man 
reproduces this section as well as any other sections named man that may exist in other chapters of 
the manual, e.g. man(7). 
FILES 
/usr/man/man?/* 
/usr/spool/man/* 
SEE ALSO 
troff(1), eqn(1), tc(1), man(7) 
BUGS 


The manual was intended to be typeset; some detail is sacrificed on terminals. 

You can’t ask for manual pages named | through 9. 

Certain manual pages (those that need egn ) terminate the output under option -t, causing any following 
pages to be lost. 
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NAME 
matlab — interactive matrix desk calculator 
SYNOPSIS 
/usr/Ibin/matlab 
DESCRIPTION 
Matlab reads commands from the standard input and manipulates complex matrices. Special cases include 
real matrices and scalars. Operations include pseudoinversion (which is inversion for square nonsingular 
matrices), eigendecomposition, various other factorizations, solution of linear equations, matrix products 
(including inner and outer products), Kronecker products, log, exponential and trigonometric functions of 
matrices, and rank and condition estimation. Variables are alphanumeric strings of at most 4 characters. 
Case is ignored. Expressions and assignment statements are written as in Fortran, and multiple statements 
can be put on one line, separated by either a comma or a semicolon; the result of a statement is written on 
the standard output unless a semicolon follows the statement. Extensions to Fortran notation include: 
Matrix construction from elements. Elements in a row are separated by commas; columns are separated by 
semicolons; matrices are surrounded by < > brackets. 
Transpose is indicated by postfix prime ’ . 
Consecutive integers are denoted by colons in the style 1:4 or 1:8:2 (meaning 1,3,5,7). 
Identity matrix is denoted ‘eye’; its dimensions are dictated by context. 
Reverse division is denoted by \. For example, ‘x = A \ b’ is roughly the same as ‘x = inv(A) * b’, except 
that Gaussian elimination, if applicable, is used to compute x. 
Some matlab commands: 
help 
help word 
List commands and functions; ‘help word’ lists information on word. It is useful to look over the 
complete help file and the MATLAB User’s Guide (see below). 
save(‘file’) 
save(‘file [,var]...’) 
Save all current variables, or just the designated variables in file. 
load(‘file’) 
Restore saved variables. 
exec(‘file’) 
Execute the commands in file before reading more commands from the standard input. 
Matlab can be called as a subroutine — for details, see the MATLAB User’s Guide or type ‘help user’. 
FILES 
/usr2/matlab/help — original help file. 
/usr/llib/mathelp.dac and /usr/llib/mathelp.idx — direct-access help file. 
/usr2/matlab — source directory. 
/usr2/matlab/src/helper.f edit this to change location of the direct-access help file, then do ‘make’ in the 
(above) matlab source directory. 
/usr2/matlab/demo — demonstration file: use exec(’/usr2/matlab/demo’ ) 
SEE ALSO 
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Cleve Moler, ‘MATLAB User’s Guide’, Technical Report CS81-—1 (Revised), Dept. of Computer Science, 
University of New Mexico, 1982. 
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NAME 
mesg — permit or deny messages 
SYNOPSIS 
mesg [n][y ] 
DESCRIPTION 
Mesg with argument n forbids messages via write(1) by revoking non-user write permission on the user’s 
terminal. Mesg with argument y reinstates permission. All by itself, mesg reports the current state without 
changing it. 
FILES 
/dev/tty* 
SEE ALSO 
write(1) 
DIAGNOSTICS 


Exit status is 0 if messages are receivable, | if not, 2 on error. 
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NAME 
mkdir — make a directory 

SYNOPSIS 
mkdir dirname ... 

DESCRIPTION 
Mkdir creates specified directories in mode 777, subject to masking by umask(2). Standard entries, *.’, for 
the directory itself, and ‘..’ for its parent, are made automatically. 
Mkdir requires write permission in the parent directory. 

SEE ALSO 
rm(1) 

DIAGNOSTICS 


Mkdir returns exit code 0 if all directories were successfully made. Otherwise it prints a diagnostic and 
returns nonzero. 
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NAME 


monk, monksample — typeset documents and letters 


SYNOPSIS 


monk [ options ] [ files ] 


monksample [ sample ] 


DESCRIPTION 


FILES 
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Monk formats the text in the named files for phototypesetting, using other troff(1) preprocessors as neces- 
sary. Options are given below. Any other arguments or flags (e.g., -01—2) are passed to troff(1). Options 
can occur in any order and can be intermixed with files. If no arguments are given, monk prints a list of its 
options. 


—Acommands 

Invoke the commands after all preprocessors and before troff(1). 
-—Bcommands 

Invoke the commands after monk and before any other preprocessor. 
-E Invoke the -e option of troff(1). 
-Rfile Use file as the index file for refer(1). 
-Tdest Prepare output for typesetter or terminal dest; Where dest can be: 


-T202 Mergenthaler Linotron 202 

-T9700 Xerox 9700 printer 

-Taps Autologic APS-5 

-Tcanon Canon laser printer, see candest(7) (default) 
-Tcat Graphic Systems C/A/T 


-Timagen Imagen printer, see i/Osend(1) 

-Tjerq 5620 or blit terminal 
-T- The output from troff(1) is placed on standard output instead of the default printer. 
-x Shows the preprocessors that are being invoked. 


The following options are not normally needed because monk automatically determines which preprocessor 
are required. However, if the commands in —A or -B options require a preprocessor, you can force monk to 
invoke them using the following options. 


-c col(1) (postprocessor) 
-cn cite(1) 

-e eqn(1) 

-g — grap(1) 

-i ideal(1) 

-p __ pic(1) 

-r refer(1) 

-S soelim(1) 

-t tbl(1) 

-tp tped(1) 


Monksample produces on the standard output a skeleton document that you can redirect into a file and edit. 
If no argument is given, monksample prints a list of the available samples. They are: 


cspress Computer Science Press galley sheets. 
letter Personal letter 
model JEEE/ACM model sheets. 


rp AT&T Bell Laboratories release paper. 

song Song sheets for singing at nursing homes. 

tm AT&T Bell Laboratories technical memorandum. 
/usr/lib/monk/cite forward and backward reference preprocessor 


/ustr/lib/monk/db monk databases 
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/usr/lib/monk/dorefer sed script for refer(1) 
/usr/lib/monk/monk monk compiler 

/usr/lib/monk/soelim preprocessor for troff(1) ‘.so’ directives 
/usr/lib/monk/tmac.p macros for pic(1) preprocessor 
/usr/lib/monk/sample directory for existing samples 


SEE ALSO 
Murrel, S. L., Kowalski, T. J., Typing Documents on the UNIX System: Using Monk 0.2 
apsend(1), cite(1), d202(1), eqn(1), grap(1), ideal(1), ped(9.1), pic(1), proof(9.1), refer(1), tbl(1), troff(1) 
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NAME 
mv — move or rename files and directories 


SYNOPSIS 
mv file! file2 


mv file ... directory 


DESCRIPTION 
Mv moves (changes the name of) file/ to file2. 


If file2 already exists, it is removed before file] is moved. If file2 has a mode which forbids writing, mv 
prints the mode (see chmod(2)) and reads the standard input to obtain a line; the move is done only if the 
line begins with y. 


In the second form, one or more files are moved to the directory with their original file-names. 
My refuses to move a file onto itself. 


SEE ALSO 
cp(1), chmod(2) 
BUGS 
If file] and file2 lie on different file systems, mv must copy the file and delete the original. In this case the 


owner name becomes that of the copying process and any linking relationship with other files is lost. 
Mv should have a -f option, like rm. 
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NAME 
netnews — send or receive news articles 
SYNOPSIS 
netnews [ —a [ date ]] [—-n newsgroups ] [ -t titles ] [-Ipr ] 
netnews —s [ newsgroups ] 
netnews -i title [| -n newsgroups ] 
DESCRIPTION 
Netnews is an intercomputer news service. Without argument it prints recent articles. After each article a 
command is read from the standard input. 
newline Go on to next article. 
p Print article again. 
- Go back to previous article. 
c Cancel (restricted to contributor and superuser). 
w file Append a copy of the article to the named file. 
rt Reply to author (via mail). 
q Exit. 
X Exit without update. 
Option —p prints with no questions asked. Option -r prints in reverse time order. Option -1 prints titles 
only. 
Normally, printed articles must 
(1) be more recent than your last use of netnews; option —a adjusts the time threshold (no date means 
the beginning of time) 
(2) be in one of the user’s newsgroups. Option —n specifies different newsgroups. 
(3) have no particular title. Option -t restricts titles to contain one of the specified strings. 
Option —s prints the list of newsgroups to which the user subscribes, or, if newsgroups are given, specifies a 
new subscription list. Newsgroup ‘ALL’ receives all articles. ‘NET.ALL’ receives all newsgroups that begin 
with ‘NET.’. All users subscribe to the newsgroup ‘general’. 
Netnews -i inserts an article (read from standard input) with title title to the newsgroups specified by —n 
(default ‘general’). 
EXAMPLES 
netnews —a last tues -n ALL 
Read all news since Tuesday. 
netnews —alr 
Print titles of all news articles of interest, most recent first. 
netnews —s ALL !NET.ALL 
Subscribe to all local articles, and no NET articles (obscure feature). 
FILES 
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/usr/spool/news/sys.nnn news articles 

/usr/spool/news/.bitfile bit map of users with news 

/ust/spool/news/.ngfile list of newsgroups to which it is legal to subscribe or submit news 
/usr/spool/news/.uindex index of netnews users 

/usr/spool/news/.nindex index of news articles 

/usr/spool/news/.seq sequence number of last article 


NETNEWS(1) Eighth Edition (not alice) NETNEWS (1) 


/usr/spool/news/.history list of all articles ever seen 
/usr/spool/news/.sys system subscription list 


SEE ALSO 
mail(1), news(1), uucp(1) 


BUGS 
Netnews and readnews (1) use the same text in different churches. 
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NAME 
newer — test file modification dates 


SYNOPSIS 
newer file! file2 


DESCRIPTION 
Newer yields a zero return code if file] exists and file2 does not, or if file and file2 both exist and filel’s 
modification time is at least as recent as that of file2. It yields a non-zero return code otherwise. 
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NAME 

newegrp — log in to a new group 
SYNOPSIS 

newgrp group 


DESCRIPTION 
Newgrp changes the group identification of its caller. The same person remains logged in, and the current 
directory is unchanged, but calculations of access permissions to files are performed with respect to the new 
group ID. 
A password is demanded if the group has a password and the user himself does not. 
Newgrp is known to the shell, which executes it directly without a fork. 


FILES 
/etc/group, /etc/passwd 


SEE ALSO 
login(8), group(5) 
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NEWS(1) Eighth Edition NEWS(1) 


NAME 


news — print news items 


SYNOPSIS 


news [-a][-n][-s][item... ] 


DESCRIPTION 


When invoked without options, this simple local news service prints files that have appeared in /usr/news 
since last reading, most recent first, with each preceded by an appropriate header. The time of reading is 
recorded. The options are 


-a print all items, regardless of currency. The recorded time is not changed. 


—n report the names of the current items without printing their contents, and without changing the 
recorded time. 


-s report the number of current items. 
Other arguments select particular news items. 


If a delete is typed during the printing of a news item, printing stops and the next item is started. A second 
delete within a second of the first causes the program to terminate. 


To post a news item, simply create a file in /usr/news. 


FILES 

/usr/news/* 

$HOME.news_time date of last read news 
SEE ALSO 
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calendar(1), netnews(1) 


NICE(1) Eighth Edition NICE(1) 


NAME 
nice, nohup — run commands at low priority or immune to hangup 


SYNOPSIS 
nice [ —number | command [ arguments ] 


nohup command [ arguments ] 


DESCRIPTION 
Nice executes command with low scheduling priority. If the number argument is present, the priority is 
incremented (higher numbers mean lower priorities) by that amount up to a limit of 20. The default number 
is 10. 


The super-user may run commands with priority higher than normal by using a negative priority, e.g. 
‘—10’. 

Nohup executes command immune to hangup and terminate signals from the controlling terminal. The pri- 
ority is incremented by 5. 


Any output not explicitly redirected is appended to the file ‘nohup.out’ in the current directory. 


FILES 
nohup.out standard output and standard error file under nohup 


SEE ALSO 
nice(2) 
DIAGNOSTICS 
Nice returns the exit status of the subject command. 


BUGS 
Quoted arguments don’t work right in all cases. The difficulty may be avoided by quoting the command, 
with arguments in inner quotes. 
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NM(1) Eighth Edition NM(1) 


NAME 
nm — print name list 


SYNOPSIS 
nm [ —agnopru | [ file ... ] 


DESCRIPTION 
Nm prints the name list (symbol table) of each object file in the argument list. If an argument is an archive, 
a listing for each object file in the archive will be produced. If no file is given, the symbols in ‘a.out’ are 
listed. 


Each symbol name is preceded by its value (blanks if undefined) and one of the letters U (undefined), A 
(absolute), T (text segment symbol), D (data segment symbol), B (bss segment symbol), C (common sym- 
bol), f file name, or — for sdb symbol table entries (see —a below). If the symbol is local (non-external) the 
type letter is in lower case. The output is sorted alphabetically. 


Options are: 
-a Include all symbols in candidates for printing; normally symbols destined for sdb(1) are excluded. 


-g Print only global (external) symbols. 


—n Sort numerically rather than alphabetically. 
-0 Prepend file or archive element name to each output line rather than only once. 
-p Don’t sort; print in symbol-table order. 
-r Sort in reverse order. 
-u Print only undefined symbols. 
SEE ALSO 


ar(1), ar(5), a.out(5), stab(5) 
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NUMBER (1) Eighth Edition NUMBER(1) 


NAME 
number — convert Arabic numerals to English 


SYNOPSIS 
number 


DESCRIPTION 
Number copies the standard input to the standard output, replacing all decimal numbers by their spelled-out 
equivalent. Punctuation is added to make the output sound well when played through voice synthesizers. 
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OD(1) 


NAME 


SYNOPSIS 


SEE ALSO 
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Eighth Edition OD(1) 


od — octal dump 


od [ —bedox ] [ file ] [ [ + Joffset[. ][ b ] ] 


DESCRIPTION 
Od dumps file in one or more formats as selected by the first argument. If the first argument is missing, —o 
is default. The meanings of the format argument characters are: 


b 


c 


d 
0 


x 


Interpret bytes in octal. 


Interpret bytes in ASCII. Certain non-graphic characters appear as C escapes: null=\0, backspace=\b, 
formfeed=\f, newline=\n, return=\r, tab=\t; others appear as 3-digit octal numbers. 


Interpret words in decimal. 
Interpret words in octal. 


Interpret words in hex. 


The file argument specifies which file is to be dumped. If no file argument is specified, the standard input is 
used. 


The offset argument specifies the offset in the file where dumping is to commence. This argument is nor- 
mally interpreted as octal bytes. If *.’ is appended, the offset is interpreted in decimal. If ‘b’ is appended, 
the offset is interpreted in blocks of 512 bytes. If the file argument is omitted, the offset argument must be 
preceded ‘+’. 


Dumping continues until end-of-file. 


adb(1) 


P(1) Eighth Edition P(1) 


NAME 
p. More — paginate 
SYNOPSIS 
p[-n] [file]... 
more [ option ] ... [ file ] ... 
DESCRIPTION 
P copies its standard input, or the named files if given, to its standard output, stopping at the end of the 
22nd line to wait for a newline from the user. The page size may be set by saying (for example) 
p -60 
While waiting for a newline, p interprets some commands: 
- Reprint last page. ‘—’ reprints the second last page, etc. 
! Pass the rest of the line to the shell as a command. 
q Quit. 
More, a paginator that lives up to its name, has too many features to describe. The essential fact about it is 
that space, not newline, gives the next page. 
SEE ALSO 
tk(1) 
BUGS 


Because of limited storage, p can’t back up too far. 
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PACK(1) Eighth Edition PACK(1) 


NAME 
pack, pcat, unpack — compress and expand files 


SYNOPSIS 
pack [ —- ] file ... 


peat [ file ] ... 
unpack file ... 


DESCRIPTION 
Pack attempts to compress the files and places the results in corresponding files named file.z with the same 
access modes, dates, and owner as the originals. Successfully packed files are removed. 


Unpack reverses the process. 
Pcat unpacks files to the standard output by analogy with cat(1). 
The .z suffix may be omitted from the name of the input file for unpack or pcat. 


Pack encodes individual characters in a Huffman code. Option — causes statistics of the encoding to be 
printed. The option toggles on and off at each appearance among the list of files. 


DIAGNOSTICS 
The return value of pack, unpack, or pcat is the number of files it failed to process. No packing happens 
when the input can’t be read or appears to be packed already, the output file name exists or is too long or 
can’t be created, or the input has links or is a directory. 
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PAPER (1) Eighth Edition PAPER (1) 


NAME 
paper — list input on HP2621P printer 


SYNOPSIS 
paper [ file ] ... 


DESCRIPTION 
paper prints the argument files (or the standard input if there are no arguments) on the user’s terminal 
which is assumed to be a HP2621P. A handshaking protocol is used to prevent overrunning the terminal’s 
buffer and dropping characters. 
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PASCAL (1) Eighth Edition PASCAL(1) 


NAME 
pascal — language interpreter 


SYNOPSIS 
pascal [ options ] [-i name ... ] [ name.p ] [ obj [ argument ... ] ] 


pmerge name,p ... 


DESCRIPTION 
Pascal translates Pascal source programs to interpretable form, executes them, or both. Under option —c the 
programs are translated but not executed. The translated code appears in file ‘obj’. Under option —x pascal 
interprets the previously translated code in file obj (default “‘obj’). Arguments are made available through 
the built-ins ‘argc’ and ‘argv’. 


Options is a string chosen from the following letters: 
c Translate only. This option must be first if it appears at all. It is inconsistent with —x. 
b Buffer the runtime file ‘output’. 


Make a program listing during translation. 


n List each included file on a new page with a banner line. 

p Suppress the post-mortem control flow backtrace if an error occurs; override execution limit of 
500,000 statements. 
Accept standard Pascal only; non-standard constructs cause warning diagnostics. 

t Suppress runtime tests of subrange variables and treat assert statements as comments. 

u Card image mode; only the first 72 characters of input lines are used. 

w Suppress warning diagnostics. 

x Execute only. If this option appears, it must be first. It is inconsistent with the —c option. 

Z Cause the interpreter to gather profiling data for later analysis by pxp(1). 


Option -i causes the named procedures and include files to be listed. 


Pmerge combines the named source files into a singlesource files on the standard output. 


FILES 
*.p input file 
*1 include file(s) 
/usr/lib/pi2.0strings error messages 
/usr/lib/how_pi* basic usage explanation 
/usr/lib/pascal/* interpreter passes 
obj interpreter code output 
/tmp/pix* obj file used by pix 
pmon.out profile data file 

SEE ALSO 


Berkeley Pascal User’s Manual (there pascal is called pi, px, and pix) 
pe(1), pxp(1) 

DIAGNOSTICS 
The first character of an error message indicates its class: 


E Fatal error; no code will be generated. 

e Non-fatal error. 

w Warning — a potential problem. 

S Warning — nonstandard Pascal construct. 


BUGS 
The keyword ‘packed’ is recognized but has no effect. 
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PASCAL (1) Eighth Edition PASCAL(1) 


Diagnostics relating to the last procedure in an included file may appear after the beginning of the listing of 
the next. 
If both source files and arguments are specified, obj is a dummy. 
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PASSWD (1) Eighth Edition PASSWD (1) 


NAME 


passwd — change login password 


SYNOPSIS 


passwd [ —an ] [ name ] 


DESCRIPTION 


This command changes (or installs) a password associated with the user name (your own name by default). 


The program prompts for the old password and then for the new one. The caller must supply both. The 
new password must be typed twice, to forestall mistakes. 


New passwords must be at least four characters long if they use a sufficiently rich alphabet and at least six 
characters long if monocase. These rules are relaxed if you are insistent enough. 


Only the owner of the name or the super-user may change a password; the owner must prove he knows the 
old password. 


If the —a option is given, passwd prompts for new values of certain fields of the password file entry. 


The super-user may use the —n option to install new users. The prompts are self-explanatory, and most of 
the defaults obvious. A null response to the ‘‘UID:’’ prompt assigns a numeric userid one greater than the 
largest one previously in /etc/passwd. A null response to the ‘‘Directory:’’ prompt assigns the user a home 
directory in /usr. If the first character of the response to this prompt is an asterisk, the remaining characters 
are taken as the name of the new user’s home directory, and a symbolic link to this directory is placed in 
/usr. A user can be assigned a directory with a name of the form /dir/username by replying *dir. 


A new user’s home directory starts with a file named .profile. This file is a copy of /etc/stdprofile with \N 
replaced by the user’s name, and \D replaced by the name of the user’s home directory. 


FILES 
/etc/passwd 
/etc/stdprofile 
SEE ALSO 


BUGS 
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passwd(5), crypt(3) 
Robert Morris and Ken Thompson, UNIX password security 


The password file information should be kept in a different data structure allowing indexed access. 


PIC(1) 


NAME 


Eighth Edition PIC(1) 


pic — troff preprocessor for drawing pictures 


SYNOPSIS 


pic [-Tr][-D] [ files ] 


DESCRIPTION 


Pic is a troff(1) preprocessor for drawing figures on a typesetter. The basic objects are box, line, arrow, 
spline, circle, ellipse, arc, and text. These may be positioned in absolute coordinates or relative to previ- 
ously placed objects. Pic also provides blocks, variables, expressions, built-in functions, loops, condition- 
als, and a macro processor. 


The optional argument —T? specifies typesetter ¢; currently supported typesetters are 202 (the default), cat 
(Graphic Systems CAT), and aps (Autologic APS-5). 


The argument —D causes pic to generate troff commands that draw lines of higher quality. Recommended 
for final copy on typesetters. 


SEE ALSO 
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B. W. Kernighan, PIC — A Graphics Language for Typesetting 
ideal(1), ped(9.1), doctype(1) 


PICK(1) Eighth Edition PICK(1) 


NAME 

pick — pick arguments 
SYNOPSIS 

pick [ - | arg... ] 
DESCRIPTION 


Pick writes each argument to the standard error and reads a reply. If the reply is y, the argument is echoed 
to the standard output; if the reply is g, pick exits without reading any more arguments; there is no output 
for any other response. If the first argument to pick is a — the selection is for each line of the standard input, 
rather than arguments. 


Pick is useful for interactive selection of argument lists, as in 
we pick *.[ch]” 
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PLOT (1) Eighth Edition PLOT(1) 


NAME 
plot — graphics filters 


SYNOPSIS 
plot [ -Tterminal ] 


DESCRIPTION 
These commands read plotting instructions (see plot(5)) from the standard input, and in general produce 
plotting instructions suitable for a particular terminal on the standard output. 


If no terminal type is specified, the environment parameter $TERM (see environ(5)) is used. Known 
terminals are: 


2621 hp Hewlett-Packard screen. 


4014 

tek Tektronix 4014 storage scope. 

ramtek 

202 

troff | Mergenthaler typesetter. 

5620 

jerq Teletype DMD display. 

750 

pen Hewlett-Packard pen plotter. 
FILES 

/usr/bin/hpplot 

/usr/bin/ramtek 

/usr/bin/trplot 

/usr/bin/penplot 

/usr/bin/tek 

/usr/jerq/bin/jplot 
SEE ALSO 


plot(3), plot(5) 


BUGS 
Which plotters are known depends on which computer you are on. 
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POST (1) 


NAME 


Eighth Edition POST(1) 


post — send mail to users by name 


SYNOPSIS 


post [ —w ] person ... 


post 


DESCRIPTION 


Post translates people’s real names to addresses and sends mail. If used with person arguments, it collects 
the standard input up to EOT or a line containing only a single *.’ character. It expects each person argu- 
ment to be either a form recognized by mail(1) or 


[firstname.[middlename.]]lastname[:location][:department] 


where every part except lastname may be abbreviated to a prefix. If the person identified is known to have 
a computer address, the collected input is sent there; otherwise paper mail is printed and routed to a clerk 
for forwarding. 


From most computers post routes mail through a central post office; diagnostic messages will be returned 
by mail. 
If the person argument is ambiguous, a list of possibilities is printed and you are asked to choose the 


desired person. The —w option gives the address, but sends nothing. 


To maintain mailing lists or avoid typing long addresses, you may keep an address book in 
$HOME/lib/post.addr. Each line in the file begins with an alias or mailing list name which is followed by 
one or more person arguments. 


Post with no person arguments invokes mail to read your mail. The environment parameter MAILP may be 
used to specify the mail invoked; otherwise it is /bin/mail. To update post’s directory with a new or sec- 
ondary address mail the following statement to alice!mailroom. 


UPDATE: computer!uid cmd first.init.last:loc:dept 


cmd may be IS, ANOTHER or WAS. IS makes the computer id the home address, ANOTHER, a sec- 
ondary address, and WAS deletes it. It expects the name to be identical to that in the BTL phone book. 


FILES 
/usr/spool/mail/* mailboxes 
/tmp/ma* temp file 
dead.letter unmailable text 
$HOME/lib/post.addr user address book 
/crp/post/tmail.? address lists 
/crp/post/tuid.? userid lists 
/usr/lib/post/genpost general postoffice 
/usr/lib/post/post.test test "no run" program 
SEE ALSO 
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mail(1) 
‘Electronic Mail Without Aliases,’ by R. J. Elliott and M. E. Lesk 


POSTNEWS (1) Eighth Edition (alice) POSTNEWS (1) 


NAME 

postnews — submit netnews articles 
SYNOPSIS 

postnews [ file ] 
DESCRIPTION 


Postnews submits the file as a netnews article. It prompts for title (informative, please), primary news- 
group, and other newsgroup distribution (not recommended). 


The names of newsgroups are relative pathnames of directories depending from /usr/spool/netnews, with 
slashes (/) replaced by dots (.). 


If no file is specified, postnews invokes an editor specified by the environment variable EDITOR (default 
vi(1)). The editor’s buffer is initialized with header information, which may be changed. The text of the 
article may be appended. 
For more sophisticated uses, such as posting news from a program, see the BSD manual. 

SEE ALSO 
readnews(1) 


BUGS 
The editor default is distinctly nonclassical. 
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PR(1) Eighth Edition PR(1) 


NAME 

pr — print file 
SYNOPSIS 

pr [ option]... [ file]... 


DESCRIPTION 
Pr produces a printed listing of one or more files. The output is separated into pages headed by a date, the 
name of the file or a specified header, and the page number. For no file arguments, or for a file argument 
‘_’, pr prints its standard input. 


Options apply to all following files but may be reset between files: 


—n Produce n-column output. 
+n Begin printing with page n. 
-h Take the next argument as a page header. 


-d double space 


-—wn For purposes of multi-column output, take the width of the page to be n characters instead of the 
default 72. 
-f Use formfeeds to separate pages. Pause, ring bell, and wait for newline before beginning. 


-lIn Take the length of the page to be n lines instead of the default 66. 
-t Do not print the 5-line header or the 5-line trailer normally supplied for each page. 


—sc Separate columns by the single character c instead of by the appropriate amount of white space. A 
missing c is taken to be a tab. 


—m Print all files simultaneously, each in one column, 

—on offset the left margin n positions 

-p between pages pause, ring bell, and wait for newline 

-b Balance columns on last page, in case of multi-column output. 


Inter-terminal messages via write (1) are forbidden during a pr. 


FILES 
/dev/tty? to suspend messages. 


SEE ALSO 
cat(1), present(1) 


DIAGNOSTICS 
There are no diagnostics when pr is printing on a terminal. 


Page | 


PROF(1) Eighth Edition PROF(1) 


NAME 


prof — display profile data 


SYNOPSIS 


prof [ option ] ... [ a.out [ mon.out ... ] ] 


DESCRIPTION 


FILES 


Prof interprets files produced by monitor(3) or the —p option of cc, f77, or pascal(1). The symbol table in 
the named object file (‘a.out’ by default) is read and correlated with the profile file (‘mon.out’ by default). 
For each external symbol, the percentage of time spent executing between that symbol and the next is 
printed (in decreasing order), together with the number of times that routine was called and the number of 
milliseconds per call. If more than one profile file is specified, the output represents the sum of the profiles. 


Call counts are tallied for subroutines compiled under option —p, which also causes a profile file to be pro- 
duced automatically. 


Options are: 

-a report all symbols, not just external symbols. 
-l sort the output by symbol value 

—n sort the output by number of calls 

-s produce a summary profile file in mon.sum 
-v -low -high 


produce a graphic profile on the standard output for display by the plot(1) filters; optional numbers 
low and high, by default 0 and 100, select a percentage of the profile to be plotted 


-Z include routines with zero usage in the output 


mon.out for profile 
a.out for namelist 
mon.sum for summary profile 


SEE ALSO 


BUGS 
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monitor(3), profil(2), cc(1), plot(1) 


Beware of quantization errors. 
Prof is confused by {77 which puts the entry points at the bottom of subroutines and functions. 


PS(1) 


NAME 


Eighth Edition PS(1) 


ps — process status 


SYNOPSIS 


ps [ aFfhinrtuxnumber ] ... 


DESCRIPTION 


Ps prints information about processes. Normally, only the user’s non-shell processes are eligible for print- 
ing; specifying a includes other user’s processes; specifying x includes shell processes as well. (A stopped 
shell is printed even if the x flag is missing.) 


All output formats include, for each process, the process id, its control terminal, status, cpu time, and com- 
mand. The status is given by a sequence of letters: 


R_ Running. T Stopped. 

P Waiting for a page. S Sleeping (< 20 seconds). 

I Idle (> 20 seconds). 

W_ Swapped out. N Process is ‘nice’; see nice(1). 


R, T, P, S, and I are mutually exclusive. 


Options are given in blank-separated clusters: 


a 
Ffile 


s 5 - = 


u 
x 
number 


give information about all users (ordinarily only one’s own processes are displayed). 

display all processes having an open file; this option must be the last in a cluster. 

display file descriptors (with prepended process id). 

display file descriptors (omitting process id). 

print column headers. 

(long) print the process size, resident set size, wait channel, and parent process id. 

print unsorted (output is normally sorted by process id). 

print processes which match the current real or effective user id (normally only processes match- 
ing the current effective user id are printed). 

print processes whose controlling tty is x, where x is either (for user’s tty), or one of the 
forms printed by ps, e.g. t3 for /dev/tty3, tconso for console, tpt12 for /dev/pt/pt12, t? for pro- 
cesses with no tty, etc. This option must be the last in a cluster. 

include a name of the effective userid and cpu share in percent; sort by usage. 

include shell and init processes. 

print the designated process; must be the last option in a cluster. 


6699 


Multiple F, t, and number options are allowed; the union of all selections is printed. 


FILES 
/proc 


process images 


/dev/drum swap device 
/dev/kmemr kernel memory 


/dev 
/dev/pt 
/dev/dk 
/etc/fstab 


searched to find tty names 
searched to find pt names 
searched to find dk names 
searched to find local file system names 


/usr/net/friends _ searched to find network file system names 


SEE ALSO 


kill(1), nice(2), proc(4), oops(8) 


BUGS 


Things can change while ps is running. 
A process may alter its apparent command name and arguments. 
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PTX(1) 


NAME 


Eighth Edition PTX(1) 


ptx — permuted index 


SYNOPSIS 


ptx [ option ] ... [ input [ output ] ] 


DESCRIPTION 


FILES 


BUGS 
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Ptx generates a permuted index to file input on file output (standard input and output default). It has three 
phases: the first does the permutation, generating one line for each keyword in an input line. The keyword 
is rotated to the front. The permuted file is then sorted. Finally, the sorted lines are rotated so the keyword 
comes at the middle of the page. Ptx produces output in the form: 


xx "tail" "before keyword" "keyword and after" "head" 


where .xx may be an nroff or troff(1) macro for user-defined formatting. The before keyword and keyword 
and after fields incorporate as much of the line as will fit around the keyword when it is printed at the mid- 
dle of the page. Tail and head, at least one of which is an empty string "", are wrapped-around pieces small 
enough to fit in the unused space at the opposite end of the line. When original text must be discarded, ‘/’ 
marks the spot. 


The following options can be applied: 

-f Fold upper and lower case letters for sorting. 

-t Prepare the output for the phototypesetter; the default line length is 100 characters. 

-wn _ Use the next argument, n, as the width of the output line. The default line length is 72 characters. 


-gn Use the next argument, n, as the number of characters to allow for each gap among the four parts 
of the line as finally printed. The default gap is 3 characters. 


-o only Use as keywords only the words given in the only file. 


-i ignore 
Do not use as keywords any words given in the ignore file. If the -i and -o options are missing, 
use /usr/lib/eign as the ignore file. 


—b break 
Use the characters in the break file to separate words. In any case, tab, newline, and space charac- 
ters are always used as break characters. 


—r Take any leading nonblank characters of each input line to be a reference identifier (as to a page or 
chapter) separate from the text of the line. Attach that identifier as a 5th field on each output line. 


The index for this manual was generated using ptx. 


sort(1) 
/usr/lib/eign 


Line length counts do not account for overstriking or proportional spacing. 


PUSH(1) Eighth Edition PUSH(1) 


NAME 


push, pull — datakit remote file copy 


SYNOPSIS 


push [ -v ] machine file ... remotedir 


pull [ -v ] machine file ... localdir 


DESCRIPTION 


FILES 


Push and pull copy files between machines over Datakit. Push copies files from the local machine to the 
directory remotedir on the named machine. Pull copies files from the named machine to the directory 
localdir on the local machine. The last component of the name of a copy is the same as that of the original. 
If one of the files is a directory, a corresponding directory is created and the directory’s files are copied, 
recursively. 


Option —v announces each file as it is copied. 


Pushing and pulling involve two programs running in different contexts on different machines. In particu- 
lar, pulling to directory ‘.’ puts files in the local current directory, but pushing to ‘.’ puts files in the remote 
home directory. Shell metacharacters which are to be interpreted on the remote machine must be quoted. 


/usr/lib/Rpull and /usr/lib/Rpush, links to /usr/bin/pull and /usr/bin/push, handle the remote end of transac- 
tions. 


SEE ALSO 


dcon(1), cp(1), ropy(1) 


DIAGNOSTICS 
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Messages marked ‘(remote)’ are from the sister process running on the remote machine. 


PWD(1) Eighth Edition PWD(1) 


NAME 
pwd, where — print machine name and working directory 
SYNOPSIS 
pwd 
where 
DESCRIPTION 
Pwd prints the pathname of the working (current) directory. 
Where prints the name of the machine and the pathname of the current directory in the form 
machine!fullpathname 
SEE ALSO 


cd(1) 
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PXP(1) Eighth Edition PXP(1) 


NAME 
pxp, pxref — pascal printer, profiler, and cross-reference lister 


SYNOPSIS 
pxp [ -acdefjnstuw_ ] [ -23456789 ] [ -z [ name ... ] ] name.p 


pxref [ — ] name.p 


DESCRIPTION 
Pxp prints the Pascal program name.p in a standard ‘pretty’ form. Under option —z the listing is annotated 
with statement execution counts from a previous pascal(1) run. 


-a Print the bodies of all procedures and functions in the profile; even those which were never exe- 
cuted. 

-d Include declaration parts in a profile. 

-e Eliminate include directives when reformatting a file; the include is replaced by the reformatted 


contents of the specified file. 


-f Fully parenthesize expressions. 

-j Left justify all procedures and functions. 

—n Eject a page as each file is included; in profiles, print a blank line at the top of the page. 

-s Strip comments from the input text. 

-t Print only a table of counts of procedure and function calls. 

-u Card image mode; only the first 72 characters of input lines are used. 

-w Suppress warning diagnostics. 

-Z Generate an execution profile. The presence of any names causes the profile to be restricted to the 


named procedures, functions, and include files. 
—_ Underline keywords. 


—d With da digit, 2 <d <9, use d spaces as the indenting unit. The default is 4. 


Pxref makes a line-numbered listing and cross-reference index for name.p. The optional — argument sup- 
presses the listing. 


FILES 
*.p input files 
* 1 include files 
pmon.out profile data 
/usr/lib/how_pxp information on basic usage 
SEE ALSO 
Berkeley Pascal User’s Manual 
pascal(1) 
BUGS 


Pxref trims identifiers to 10 characters and pads lines with blanks. 
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RANDOM(1) Eighth Edition RANDOM(1) 


NAME 
random — sample lines from a file or provide random exit code 
SYNOPSIS 
random [ -e ] [ n ] 
DESCRIPTION 
Random reads the standard input and copies each line to the standard output with probability 1/n. 
Option —e writes no output and returns a random exit code in the range [0,n-1]. 
The default value of n is 2. 
To select just one line randomly from a file use fortune (6). 
BUGS 


Successive results of option —e are highly correlated if random is called more than once per second. 
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NAME 
ranlib — convert archives to random libraries 
SYNOPSIS 
ranlib archive ... 
DESCRIPTION 
Ranlib converts each archive to a form which can be loaded more rapidly by the loader, by adding a table 
of contents named ‘__.SYMDEF’ to the beginning of the archive. It uses ar(1) to reconstruct the archive, 
so that sufficient temporary file space must be available in the file system containing the current directory. 
SEE ALSO 
Id(1), ar(1), lorder(1) 
BUGS 


Because generation of a library by ar and randomization by ranlib are separate, phase errors are possible. 
The loader /d warns when the modification date of a library is more recent than the creation of its dictio- 
nary; but this means you get the warning even if you only copy the library. 
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NAME 

ratfor — rational Fortran dialect 
SYNOPSIS 

ratfor [ option ... ] [ filename ... ] 
DESCRIPTION 


Ratfor converts a rational dialect of Fortran into ordinary irrational Fortran. Ratfor provides control flow 
constructs essentially identical to those in C: 


statement grouping: 
{ statement; statement; statement } 


decision-making: 
if (condition) statement [ else statement | 
switch (integer value) { 
case integer: statement 


[ default: ] statement 
} 


loops: while (condition) statement 
for (expression; condition; expression) statement 
do limits statement 
repeat statement [ until (condition) ] 
break 
next 


and some syntactic sugar to make programs easier to read and write: 


free form input: 
multiple statements/line; automatic continuation 


comments: 
# this is a comment 


translation of relationals: 
>, >=, etc., become .GT., .GE., etc. 


return (expression) 
returns expression to caller from function 


define: define name replacement 
include: include filename 
Ratfor is best used with f77(1). 


SEE ALSO 
efl(1), £77(1), struct(1) 
B. W. Kernighan and P. J. Plauger, Software Tools, Addison-Wesley, 1976. 
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NAME 


checknews, readnews — read news articles 


SYNOPSIS 


checknews [ ynqve | [ readnews-options ] 
readnews [ —a date | [ -n newsgroup ] [ -+ titles ] [ -IprxhfuM ] [ -c [ mailer ] ] 


readnews —s 


DESCRIPTION 
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Checknews reports whether there is news present. 

y report only if news is present 

n report only if news is absent 

q turn off reports; nonzero exit status indicates news. 
v 


alters the y message to show the name of the first newsgroup containing unread news. Doubling v 
(e.g. vv) causes an explanation of any claim of new news, and is useful if checknews and 
readnews disagree. 


e executes readnews (1) if there is news 
If there are no options, y is the default. 


Readnews without arguments prints unread articles. There are several interfaces available besides the 
default: 


Flag Interface 
—-M An interface to Mail(1). 
-c A /bin/mail(1)-like interface. 


-c ‘mailer’ All selected articles written to a temporary file. Then the mailer is invoked. The name of the 
temporary file is referenced with a *%’. Thus, ‘mail -f %’ will invoke mail on a temporary file 
consisting of all selected messages. 


-p All selected articles are sent to the standard output. No questions asked. 
-l Only the titles output. The .newsrc file will not be updated. 


The -r flag causes the articles to be printed in reverse order. The -f flag prevents any followup articles 
from being printed. The —-h flag causes articles to be printed in a less verbose format, and is intended for 
terminals running at 300 baud. the -u flag causes the .newsre file to be updated every 5 minutes, in case of 
an unreliable system. (Note that if the newsrc file is updated, the x command will not restore it to its origi- 
nal contents.) 


The following flags determine the selection of articles. 


—n newsgroups 
Select all articles that belong to newsgroups. 


-t titles Select all articles whose titles contain one of the strings specified by titles. 
-a[ date] Select all articles that were posted past the given date. 
-x Ignore .newsrc file. That is, select articles that have already been read as well as new ones. 


readnews maintains a .newsrc file in the user’s home directory that specifies all news articles already read. 
It is updated at the end of each reading session in which the —-x or -l options weren’t specified. If the envi- 
ronment variable NEWSRC is present, it should be the path name of a file to be used in place of .newsrc. 


If the user wishes, an options line may be placed in the .newsrc file. This line starts with the word options 
(left justified) followed by the list of standard options just as they would be typed on the command line. 
Such a list may include: the —-n flag along with a newsgroup list; a favorite interface; and/or the -r or -t 
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flag. Continuation lines are specified by following lines beginning with a space or tab character. Similarly, 
options can be specified in the NEWSOPTS environment parameter. Where conflicts exist, option on the 
command line take precedence, followed by the .newsrc options line, and lastly the NEWSOPTS parame- 
ter. 


readnews -s will print the newsgroup subscription list. 


When user uses the reply command of the default or mail interfaces, the environment parameter MAILER 
will be used to determine which mailer to use. The default is usually /bin/mail. 


If the user so desires, he may specify a specific paging progam for articles. The environment parameter 
PAGER should be set to the paging program. The name of the article is referenced with a ‘%’, as in the -c 
option. If no ‘%’ is present, the article will be piped to the program. Paging may be disabled by setting 
PAGER to a null value. 


COMMANDS 
This section lists the commands you can type to the msgs and /bin/mail interface prompts. The msgs inter- 
face will suggest some common commands in brackets. Just hitting return is the same as typing the first 
command. For example, ‘[ynq]’ means that the commands ‘‘y’’ (yes), “‘n’’ (no), and ‘q’ (quit) are common 


responses, and that “‘y’’ is the default. Command Meaning 
y Yes. Prints current article and goes on to next. 
n No. Goes on to next article without printing current one. In the /bin/mail interface, this means ‘go 


on to the next article’, which will have the same effect as “y’ or just hitting return. 


q Quit. The .newsrc file will be updated if —] or —x were not on the command line. 
c Cancel the article. Only the author or the super user can do this. 
rt Reply. Reply to article’s author via mail. You are placed in your EDITOR with a header specify- 


ing To, Subject, and References lines taken from the message. You may change or add headers, as 
appropriate. You add the text of the reply after the blank line, and then exit the editor. The result- 
ing message is mailed to the author of the article. 


rd Reply directly. You are placed in $MAILER (‘mail’ by default) in reply to the author. Type the 
text of the reply and then control-D. 


f [title] Submit a follow up article. Normally you should leave off the title, since the system will generate 
one for you. You will be placed in your EDITOR to compose the text of the followup. 


fd Followup directly, without edited headers. This is like f, but the headers of the article are not 
included in the editor buffer. 


N [newsgroup | 
Go to the next newsgroup or named newsgroup. 


s [file] Save. The article is appended to the named file. The default is ‘Articles’. If the first character of 
the file name is ‘|’, the rest of the file name is taken as the name of a program, which is executed 
with the text of the article as standard input. If the first character of the file name is ‘/’, it is taken 
as a full path name of a file. If $NEWSBOX (in the environment) is set to a full path name, and 
the file contains no ‘/’, the file is saved in $NEWSBOX. Otherwise, it is saved relative to 
$HOME. 


+ 


Report the name and size of the newsgroup. 
Erase. Forget that this article was read. 
Print a more verbose header. 


Print a very verbose header, containing all known information about the article. 


CS 4 ee 


Unsubscribe from this newsgroup. Also goes on to the next newsgroup. 
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d Read a digest. Breaks up a digest into separate articles and permits you to read and reply to each 
piece. 
D [number] 


Decrypt. Invokes a Caesar decoding program on the body of the message. This is used to decrypt 
rotated jokes posted to net.jokes, to avoid possible offense to uninterested readers. The title of the 
joke should indicate the nature of the problem, enabling people to decide whether to decrypt it or 
not. 


Normally the Caesar program does a character frequency count on each line of the article separately, so that 
lines which are not rotated will be shown in plain text. This works well unless the line is short, in which 
case it sometimes gets the wrong rotation. An explicit number rotation (usually 13) may be given to force a 
particular shift. 


Vv Print the current version of the news software. 
! Shell escape. 
number Go to number. 


+[n] Skip n articles. The articles skipped are recorded as ‘unread’ and will be offered to you again the 
next time you read news. 


- Go back to last article. This is a toggle, typing it twice returns you to the original article. 
X Exit. Like quit except that .newsrc is not updated. 


X [system] 
Transmit article to the named system. 
The commands c, f, fd, r, rd, e, h, H, and s can be followed by —’s to refer to the previous article. Thus, 


when replying to an article using the msgs interface, you should normally type ‘r—’ (or ‘‘re-’’) since by the 
time you enter a command, you are being offerred the next article. 


EXAMPLES 


FILES 


readnews_ Read all unread articles using the msgs interface. The .newsrc file is updated at the end of the 
session. 


readnews —c ‘‘ed %’”’ 1 
Invoke the ed(1) text editor on a file containing the titles of all unread articles. The .newsrc file 
is not updated at the end of the session. 


readnews —n all !fa.all -M -r 
Read all unread articles except articles whose newsgroups begin with "fa." via Mail(1) in 
reverse order. The .newsrc file is updated at the end of the session. 


readnews —p —n all —a last thursday 
Print every unread article since last Thursday. The .newsrc file is updated at the end of the ses- 
sion. 


readnews —p > /dev/null & 
Discard all unread news. This is useful after returning from a long trip. 


/ust/spool/news/newsgroup/number 
News articles 


/usr/lib/news/active Active newsgroups and numbers of articles 

/usr/lib/news/help Help file for msgs interface 

“/mewsrc Options and list of previously read articles 
SEE ALSO 
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BUGS 
Netnews and readnews use the same text in different churches. 
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NAME 


refer, lookbib, pubindex — find and insert literature references in documents 


SYNOPSIS 


refer [ option ] ... 
lookbib [ file ] ... 
pubindex file ... 


DESCRIPTION 
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Lookbib accepts keywords from the standard input and searches a bibliographic data base for references that 
contain those keywords anywhere in title, author, journal name, etc. Matching references are printed on the 
standard output. Blank lines are taken as delimiters between queries. 


Refer is a preprocessor for nroff or troff(1) that finds and formats references. The input files (standard input 
default) are copied to the standard output, except for lines between .[ and .] which are assumed to contain 
keywords and are replaced by information from the bibliographic data base. The user may avoid the search, 
override fields from it, or add new fields. The reference data, from whatever source, are assigned to a set of 
troff strings. Macro packages such as ms(7) print the finished reference text from these strings. A flag is 
placed in the text at the point of reference; by default the references are indicated by numbers. 


The following options are available: 


—ar Reverse the first r author names (Jones, J. A. instead of J. A. Jones). If r is omitted all author 
names are reversed. 


-b Bare mode: do not put any flags in text (neither numbers nor labels). 
-cstring Capitalize (with CAPS SMALL CAPs) the fields whose key-letters are in string. 


-e Instead of leaving the references where encountered, accumulate them until a sequence of the form 
[ 
$LIST$ 
| 
is encountered, and then write out all references collected so far. Collapse references to the same 
source. 


-kx Instead of numbering references, use labels as specified in a reference data line beginning %x; by 
default x is L. 


-Im,n Instead of numbering references, use labels made from the senior author’s last name and the year 
of publication. Only the first m letters of the last name and the last n digits of the date are used. If 
either m or n is omitted the entire name or date respectively is used. 


-p Take the next argument as a file of references to be searched. The default file is searched last. 
—n Do not search the default file. 


-skeys Sort references by fields whose key-letters are in the keys string; permute reference numbers in text 
accordingly. Implies -e. The key-letters in keys may be followed by a number to indicate how 
many such fields are used, with + taken as a very large number. The default is AD which sorts on 
the senior author and then date; to sort, for example, on all authors and then title use -sA+T. 


A bibliographic reference in a -p file is a set of lines that contain bibliographic information fields. Empty 
lines separate references. Each field starts on a line beginning with a *%’, followed by a key-letter, fol- 
lowed by a blank, and followed by the contents of the field, which continues until the next line starting with 
‘%’. The most common key-letters and the corresponding fields are: 


A Author name 

B Title of book containing article referenced 
C City 

D Date 
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Alternate date 

Editor of book containing article referenced 
Government (CFSTI) order number 

Issuer (publisher) 

Journal 

Other keywords to use in locating reference 
Technical memorandum number 

Issue number within volume 

Other commentary to be printed at end of reference 
Page numbers 

Report number 

Alternate report number 

Title of article, book, etc. 

Volume number 

Commentary unused by pubindex 


x< oO" AVOAZZAT OMe 


Except for ‘A’, each field should only be given once. Only relevant fields should be supplied. An example 
is: 


%T 5-by-5 Palindromic Word Squares 
%A M. D. Mclilroy 

%J Word Ways 

%V 9 

%P 199-202 

%D 1976 


When refer is used with eqn, neqn or tbl, refer should be first, to minimize the volume of data passed 
through pipes. 
Pubindex makes a hashed inverted index to the named files for use by refer. The files contain bibliographic 


references. 


FILES 
/asr/dict/papers directory of default publication lists and indexes 
/usr/lib/refer directory of programs 
XFR.ia, xFR.ib, xFR.icwhere x is the first argument to pubindex 


SEE ALSO 
troff(1), doctype(1) 
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rev, revpag — reverse lines or pages 


SYNOPSIS 


rev [ file ] ... 


revpag [ option ] ... [ file ] ... 


DESCRIPTION 


Rev copies the standard input or the named files to the standard output, reversing the order of characters in 
every line. 


Revpag copies the standard input or the named files to the standard output, reversing the order of the pages. 
(The name ‘—’ means the standard input.) Options define what constitutes a ‘page’: 


-d flags the input as troff(1) output; line counts are ignored. 


-f appends a new-page character (014) to the last input page (which is the first page on the output), if 
this page is not of the declared length. 


-ln sets the number of lines per page (66 by default) in the case of ordinary ASCII input. A new-page 
character (014) is also recognized as a page break. 


-0 list produces only pages whose page numbers appear in the comma-separated list of numbers and 
ranges. A ‘page number’ means the ordinal position of a page in the input. A range n—m means 
pages n through m; a range —n means from the beginning to page n; a range n— means from page n 
to the end. Numbers and ranges may appear in any order. 


SEE ALSO 
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pr(1), troff(1), xcan(1) 
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NAME 
rm, rmdir — remove (unlink) files 

SYNOPSIS 
rm [-f][-r][-i] file ... 

DESCRIPTION 
Rm removes the entries for one or more files from a directory. If an entry was the last link to the file, the 
file is destroyed. If an entry is a directory it is removed only if empty. Removal of a file requires write per- 
mission in its directory, but neither read nor write permission on the file itself. 
If a file has no write permission and the standard input is a terminal, its permissions are printed and a line is 
read from the standard input. If that line begins with ‘y’ the file is deleted, otherwise the file remains. No 
questions are asked and no errors are reported when the -f (force) option is given. Option —r causes rm to 
recursively delete the entire contents of a directory, and the directory itself. 
If the -i (interactive) option is in effect, rm asks whether to delete each file, and, under -r, whether to 
examine each directory. 

SEE ALSO 
unlink(2), rmdir(8) 

DIAGNOSTICS 
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a) 


Generally self-explanatory. It is forbidden to remove the file *..’. merely to avoid the antisocial conse- 
quences of inadvertently doing something like ‘rm —r .*’. 
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NAME 
ropy — remote file copy for arpa internet 
SYNOPSIS 


/usr/inet/bin/ropy file! file2 
/usr/inet/bin/ropy | -r | file ... directory 


DESCRIPTION 
Ropy copies files between machines over an ARPA internet connection. Each non-option argument is either 
a remote file name of the form ‘rhost:path’, or a local path name. In the first form ropy copies file/ to file2. 
In the second form it copies one or more files into the named directory with their original file-names. 


Option -r causes ropy to copy the contents of any named directory recursively; the destination must be a 
directory. 


If path is not a full path name, it is interpreted relative to your login directory on the remote machine. 


Ropy requires rsh capability; see dcon(1). 


FILES 

/usr/inet/lib/* 

$HOME/.rhosts 
SEE ALSO 

push(1), cp(1), dcon(1), netstat(8) 
BUGS 


Ropy works by remotely executing the command rcp (sic); hence your .profile on the remote machine must 
arrange for the command rcp to invoke /usr/inet/bin/rcp , not /usr/bin/rcp . 
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sdb — symbolic debugger 


SYNOPSIS 


sdb [ objfil [ corfil [ directory ] ] ] 


DESCRIPTION 
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Sdb is a symbolic debugger. It may examine source and/or object files and provide a controlled environ- 
ment for execution. 


Objfil is an executable program file which has been compiled with the -g (debug) option of cc, pascal, or 
f77(1). The default for objfil is a.out. Corfil is assumed to be a core image file produced after executing 
objfil; the default for corfil is core. Directory names the location of source files, by default the current 
directory. 


Sdb maintains a current line and a current file. If corfil exists then they are initially set to the line and file 
containing the source statement at which the process terminated or stopped. Otherwise, they are set to the 
first line in function main. 


Names of variables are written just as they are in C, Pascal, or Fortran. Variables local to a procedure may 
be accessed using the form ‘procedure:variable’. If no procedure name is given, the procedure containing 
the current line is used by default. A member of a structure may be referred to as ‘variable:member’ or 
“‘variable->member’; an array element as ‘variable[number]’. Combinations of these forms may be used. 


It is also possible to specify a variable by address. All forms of integer constants which are valid in C may 
be used. 


Line numbers in the source program are referred to as ‘filename:number’ or ‘procedure:number’. In either 
case the number is relative to the beginning of the file. If no procedure or file name is given, the current file 
is used by default. If no number is given, the first line of the named procedure or file is used. 


The commands for examining data are: 
t Print a stack trace of the terminated or stopped program. 
T Print the top line of the stack trace. 


variable/Im 
Print the value of variable according to length / and format m. If / and m are omitted, sdb chooses a 
length and format suitable for the variable’s type as declared in the program. The length specifiers 


are: 
b one byte 

h two bytes (half word) 
] four bytes (long word) 


number string length for formats s and a 
Legal values for m are: 


character 

decimal 

decimal, unsigned 

octal 

hexadecimal 

32 bit single precision floating point 

64 bit double precision floating point 

Assume variable is a string pointer and print characters until a null is reached. 
Print characters starting at the variable’s address until a null is reached. 
pointer to procedure 


sae nga merRroeogcan 


The length specifiers are only effective with the formats d, u, o and x. If one of these formats is 
specified and / is omitted, the length defaults to the word length of the host machine: 4 for the VAX. 
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The last variable may be redisplayed with the command ‘./’. The sh(1) metacharacters * and ? may 
be used within procedure and variable names, providing a limited form of pattern matching. If no 
procedure name is given, both variables local to the current procedure and global (common for f77) 
variables are matched. If a procedure name is specified, only variables local to that procedure are 
matched. The form ‘:pattern’ matches only global variables (blank common for f77),. The name of a 
common block may be specified instead of a procedure name for f77 programs. 


variable=lm 

linenumber=/m 

number=/m 
Print the address of the variable or line number or the value of the number in the specified format. If 
no format is given, then ‘lx’ is used. The last variant of this command provides a convenient way to 
convert between decimal, octal and hexadecimal. 


variabletvalue 
Set the variable to the given value. The value may be a number, character constant or a variable. If 
the variable is of type float or double, the value may also be a floating constant. 


The commands for examining source files are 


e procedure 

e filename.c 
Set the current file to the file containing the named procedure or the named filename. Set the current 
line to the first line in the named procedure or file. If no procedure or file name is given, the current 
procedure and file names are reported. 


/regular expression/ 
Search forward from the current line for a line containing a string matching the regular expression as 
in ed(1). The trailing ‘/’ may be elided. 


?regular expression? 
Search backward from the current line for a line containing a string matching the regular expression 
as ined(1). The trailing ‘?’ may be elided. 


p Print the current line. 
Z Print the current line followed by the next 9 lines. Set the current line to the last line printed. 
control-D 


Scroll. Print the next 10 lines. Set the current line to the last line printed. 
w Window. Print the 10 lines around the current line. 


number 
Set the current line to the given line number. Print the new current line. 


count + 
Advance the current line by count lines. Print the new current line. 


count — 
Retreat the current line by count lines. Print the new current line. 


The commands for controlling the execution of the source program are: 


count r args 

countR 
Run the program with the given arguments. The r command with no arguments reuses the previous 
arguments to the program while the R command runs the program with no arguments. An argument 
beginning with ‘<’ or ‘>’ causes redirection for the standard input or output respectively. If count is 
given, it specifies the number of breakpoints to be ignored. 
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linenumber ¢c count 
linenumber C count 
Continue after a breakpoint or interrupt. If count is given, it specifies the number of breakpoints to 
be ignored. C continues with the signal which caused the program to stop and c ignores it. If a 
linenumber is given then a temporary breakpoint is placed at the line and execution is continued. The 
breakpoint is deleted when the command finishes. 
count § 
Single step. Run the program through count lines. If no count is given then the program is run for 
one line. 
count S 


Single step, but step through subroutine calls. 
k Kill the debugged program. 


procedure(arg1,arg?....) 

procedure(arg 1,arg2,...)/m 
Execute the named procedure with the given arguments. Arguments can be integer, character or 
string constants or names of variables accessible from the current procedure. The second form causes 
the value returned by the procedure to be printed according to format m. If no format is given, it 
defaults to “d’. 


linenumber b commands 
Set a breakpoint at the given line. If a procedure name without a line number is given (e.g. ‘proc:’), a 
breakpoint is placed at the first line in the procedure even if it was not compiled with the debug flag. 
If no linenumber is given, a breakpoint is placed at the current line. 


If no commands are given then execution stops just before the breakpoint and control is returned to 
sdb. Otherwise the semicolon-separated commands are executed when the breakpoint is encountered 
and execution continues. 


linenumber d 
Delete a breakpoint at the given line. If no linenumber is given, each breakpoint location is printed 
and a line is read from the standard input. If the line begins with a ‘y’ or ‘d’ then the breakpoint is 
deleted. 


B Print a list of the currently active breakpoints. 
D Delete all breakpoints. 
] Print the last executed line. 


linenumber a 
Announce. If linenumber is of the form ‘proc:number’, the command does a ‘linenumber b |’. If 
linenumber is of the form ‘proc:’, the command does a ‘proc: b T’. 


Miscellaneous commands. 


! command 
The command is interpreted by sh(1). 


newline 
If the previous command printed a source line then advance the current line by | line and print the 
new current line. If the previous command displayed a core location then display the next core loca- 
tion. 


"string 
Print the given string. 


q Exit the debugger. 
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The following commands are intended for debugging the debugger. 
Vv Print the version number. 

x Print a list of procedures and files being debugged. 

Y Toggle debug output. 


FILES 
a.out 
core 
DIAGNOSTICS 
Error reports are either identical to those of adb(1) or are self-explanatory. 
SEE ALSO 
adb(1), pi(9.1), coreid(1) 
BUGS 


If a procedure is called when the program is not stopped at a breakpoint (such as when a core image is 
being debugged), all variables are initialized before the procedure is started. This makes it impossible to 
use a procedure to extract data from a core image. 


Arrays must be of one dimension and of zero origin to be correctly addressed. 
The default type for printing Fortran parameters is incorrect: address instead of value. 


Tracebacks containing Fortran subprograms with multiple entry points may print too many arguments in 
the wrong order, but their values are correct. 


Sdb understands Pascal, but not its types. 


The meaning of control-D is nonstandard 
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NAME 
sed — stream editor 


SYNOPSIS 
sed [-n ] [-e script ] [ -f sfile ] [ file ] ... 


DESCRIPTION 
Sed copies the named files (standard input default) to the standard output, edited according to a script of 
commands. The -f option causes the script to be taken from file sfile; these options accumulate. If there is 
just one -e option and no -f’s, the flag -e may be omitted. The -n option suppresses the default output. 


A script consists of editing commands, one per line, of the following form: 
[address [, address] ] function [arguments] 


In normal operation sed cyclically copies a line of input into a pattern space (unless there is something left 
after a ‘D’ command), applies in sequence all commands whose addresses select that pattern space, and at 
the end of the script copies the pattern space to the standard output (except under —n) and deletes the pattern 
space. 


An address is either a decimal number that counts input lines cumulatively across files, a ‘$’ that addresses 
the last line of input, or a context address, ‘/regular expression/’, in the style of ed(1) modified thus: 


The escape sequence ‘\n’ matches a newline embedded in the pattern space. 
A command line with no addresses selects every pattern space. 
A command line with one address selects each pattern space that matches the address. 


A command line with two addresses selects the inclusive range from the first pattern space that matches the 
first address through the next pattern space that matches the second. (If the second address is a number less 
than or equal to the line number first selected, only one line is selected.) Thereafter the process is repeated, 
looking again for the first address. 

Editing commands can be applied only to non-selected pattern spaces by use of the negation function ‘!’ 
(below). 


In the following list of functions the maximum number of permissible addresses for each function is indi- 
cated in parentheses. 


An argument denoted text consists of one or more lines, all but the last of which end with ‘V to hide the 
newline. Backslashes in text are treated like backslashes in the replacement string of an ‘s’ command, and 
may be used to protect initial blanks and tabs against the stripping that is done on every script line. 


An argument denoted rfile or wfile must terminate the command line and must be preceded by exactly one 
blank. Each wfile is created before processing begins. There can be at most 10 distinct wfile arguments. 


(1)a\ 
text 
Append. Place text on the output before reading the next input line. 


(2) b label 
Branch to the *:’ command bearing the label. If label is empty, branch to the end of the script. 


(2) c\ 

text 
Change. Delete the pattern space. With 0 or | address or at the end of a 2-address range, place 
text on the output. Start the next cycle. 


(2)d Delete the pattern space. Start the next cycle. 
(2)D Delete the initial segment of the pattern space through the first newline. Start the next cycle. 


(2)g Replace the contents of the pattern space by the contents of the hold space. 
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(2)G Append the contents of the hold space to the pattern space. 

(2)h Replace the contents of the hold space by the contents of the pattern space. 
(2)H Append the contents of the pattern space to the hold space. 

(1) i\ 


text 
Insert. Place text on the standard output. 


(2)n Copy the pattern space to the standard output. Replace the pattern space with the next line of 
input. 

(2)N Append the next line of input to the pattern space with an embedded newline. (The current line 
number changes.) 

(2)p Print. Copy the pattern space to the standard output. 

(2)P Copy the initial segment of the pattern space through the first newline to the standard output. 

(1)q Quit. Branch to the end of the script. Do not start a new cycle. 


(2)r rfile 


Read the contents of rfile. Place them on the output before reading the next input line. 


(2) s/regular expression/replacement/flags 
Substitute the replacement string for instances of the regular expression in the pattern space. Any 
character may be used instead of ‘/’. For a fuller description see ed(1). Flags is zero or more of 


g Global. Substitute for all nonoverlapping instances of the regular expression rather than 
just the first one. 

p Print the pattern space if a replacement was made. 

w wfile Write. Append the pattern space to wfile if a replacement was made. 


(2) t label 
Test. Branch to the ‘:’ command bearing the /abel if any substitutions have been made since the 
most recent reading of an input line or execution of a ‘t’. If label is empty, branch to the end of 
the script. 

(2) w wfile 
Write. Append the pattern space to wfile. 


(2)x Exchange the contents of the pattern and hold spaces. 
(2) y/string I/string2/ 


Transform. Replace all occurrences of characters in string] with the corresponding character in 
string2. The lengths of string] and string2 must be equal. 


(2)! function 
Don’t. Apply the function (or group, if function is ‘{’) only to lines not selected by the 


address(es). 
(0): label 
This command does nothing; it bears a Jabel for ‘b’ and ‘t? commands to branch to. 
(1)= Place the current line number on the standard output as a line. 
(2) { Execute the following commands through a matching ‘}’ only when the pattern space is selected. 
(0) An empty command is ignored. 
SEE ALSO 


ed(1), grep(1), awk(1), lex(1), cut(1), split(1) 


Page 2 


SEQ(1) Eighth Edition SEQ(1) 
NAME 
seq — print sequences of numbers 
SYNOPSIS 
seq [—w] [-ppicture] [ first [ incr ] ] last 
DESCRIPTION 
Seq prints the sequence of numbers, one per line, from first (default 1) to Jast, inclusive, in increments of 
incr (default 1). The numbers are interpreted as floating point. 
The default output format is to round each number to the nearest integer. This may be overridden by speci- 
fying a picture that is an example of the desired format. For example, the option —p10.00 results in num- 
bers printed to two decimal places. Leading zeroes in the picture are preserved in the output. 
The option —w causes the output lines to have constant width, by padding short numbers with leading 
zeroes, after the minus sign for negative numbers. 
BUGS 
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NAME 
server — run anonymous command on another machine 

SYNOPSIS 
server machine command 

DESCRIPTION 
Server uses Datakit to ran command on the named machine. If it has set-uid mode, the owner of server will 
log in on the remote machine. In this way, a user can execute commands on the remote machine without 
having a login there. 
Server typically accepts only a small set of commands, such as who, ps, cat, and date; the list is at the dis- 
cretion of the remote machine. Server also checks for suspicious argument characters. 

FILES 
/etc/server list of legal commands 

SEE ALSO 


dcon(1), push(1), rx(1) 
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sh, cd, wait — shell, the standard command programming language 


SYNOPSIS 


sh [ -acefiknpstuvx | [ args ] 


DESCRIPTION 


Sh is a command programming language that executes commands read from a terminal or a file. See 
Invocation below for the meaning of arguments to the shell. 


Definitions 


A blank is a tab or a space. A name is a sequence of letters, digits, or underscores beginning with a letter 
or underscore. A parameter is a name, a digit, or any of the characters *, @, #, ?, -,$, and!. A word isa 
sequence of characters and quoted strings, surrounded by blanks or newlines. 


Commands 
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A simple-command is a sequence of words separated by blanks. The first word specifies the name of the 
command to be executed. Except as specified below, the remaining words are passed as arguments to the 
invoked command. The command name is passed as argument 0 (see exec(2)). The value of a simple- 
command is its exit status if it terminates normally, or (octal) 200+status if it terminates abnormally (see 
signal(2) for a list of status values). 


A pipeline is a sequence of one or more commands separated by |. The standard output of each command 
but the last is connected by a pipe(2) to the standard input of the next command. Each command is run as a 
separate process; the shell waits for the last command to terminate. The exit status of a pipeline is the exit 
status of the last command. 


A list is a sequence of one or more pipelines separated by ;, & &&, or | |, and optionally terminated by ; 
or &. Of these four symbols, ; and & have equal precedence, which is lower than that of && and | |. The 
symbols && and | | also have equal precedence. A semicolon (;) causes sequential execution of the pre- 
ceding pipeline; an ampersand (&) causes asynchronous execution of the preceding pipeline (i.e., the shell 
does not wait for that pipeline to finish). The symbol && ( | |) causes the List following it to be executed 
only if the preceding pipeline returns a zero (non-zero) exit status. An arbitrary number of new-lines may 
appear in a list, instead of semicolons, to delimit commands. 


A command is either a simple-command or one of the following. Unless otherwise stated, the value 
returned by a command is that of the last simple-command executed in the command. 


for name [ in word ...; | do list done 
Each time a for command is executed, name is set to the next word taken from the in word list. If 
in word ... 3 is omitted, then the for command executes the do list once for each positional 
parameter that is set (see Parameter Substitution below). Execution ends when there are no more 
words in the list. 

case word in [ pattern [ | pattern |...) list 3; |... esac 
A case command executes the /ist associated with the first pattern that matches word. The form 
of the patterns is the same as that used for file-name generation (see File Name Generation ) 
except that a slash, a leading dot, or a dot immediately following a slash need not be matched 
explicitly. 

if list then list [ elif list then list |]... [ else list ] fi 
The list following if is executed and, if it returns a zero exit status, the ist following the first then 
is executed. Otherwise, the list following elif is executed and, if its value is zero, the list follow- 
ing the next then is executed. Failing that, the else list is executed. If no else /ist or then list is 
executed, then the if command returns a zero exit status. 

while list do list done 
A while command repeatedly executes the while Jist and, if the exit status of the last command in 
the list is zero, executes the do /ist; otherwise the loop terminates. If no commands in the do Jist 
are executed, then the while command returns a zero exit status; until may be used in place of 
while to negate the loop termination test. 
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(list) 
Execute list in a sub-shell. 
{list} 
list is simply executed. 
name () command 
Define a function which is referenced by name. The body of the function is the command. The 
most useful form of command is a sequence of commands enclosed by { and }. Execution of func- 
tions is described below (see Execution ). 
The following words are only recognized as the first word of a command and when not quoted: 
if then else elif fi case esac for while until do done 
Comments 


A word beginning with # causes that word and all the following characters up to a new-line to be ignored. 


Command Substitution 


The standard output from a command enclosed in a pair of grave accents (* s ) may be used as part or all of 
a word; trailing new-lines are removed. 


Parameter Substitution 


The character $ is used to introduce substitutable parameters. There are two types of parameters, posi- 
tional and keyword. If parameter is a digit, it is a positional parameter. Positional parameters may be 
assigned values by set. Keyword parameters (also known as variables) may be assigned values by writing: 


name=value [| name=value |... 


Pattern-matching is not performed on value. There cannot be a function and a variable with the same 
name . 


${parameter} 
The value, if any, of the parameter is substituted. The braces are required only when parameter is 
followed by a letter, digit, or underscore that is not to be interpreted as part of its name. If 
parameter is * or @, all the positional parameters, starting with $1, are substituted (separated by 
spaces). Parameter $0 is set from argument zero when the shell is invoked. 
${parameter:—word} 
If parameter is set and is non-null, substitute its value; otherwise substitute word. 
${parameter:=word} 
If parameter is not set or is null set it to word; the value of the parameter is substituted. Positional 
parameters may not be assigned to in this way. 
${parameter:?word} 
If parameter is set and is non-null, substitute its value; otherwise, print word and exit from the 
shell. If word is omitted, the message ‘‘parameter null or not set’’ is printed. 
${parameter:+word} 
If parameter is set and is non-null, substitute word; otherwise substitute nothing. 


In the above, word is not evaluated unless it is to be used as the substituted string, so that, in the following 
example, pwd is executed only if d is not set or is null: 


echo ${d:—* pwd. } 


If the colon (:) is omitted from the above expressions, the shell only checks whether parameter is set or 
not. 


The following parameters are automatically set by the shell: 
# The number of positional parameters in decimal. 
Flags supplied to the shell on invocation or by the set command. 
The decimal value returned by the last synchronously executed command. 
The process number of this shell. 
The process number of the last background command invoked. 
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The following parameters are used by the shell: 

HOME The default argument (home directory) for the cd command. 
PATH The search path for commands (see Execution below). 
CDPATH 


The search path for the cd command. 


MAIL If this parameter is set to the name of a mail file the shell informs the user of the arrival of 
mail in the specified file. The file is inspected every three minutes. 

HISTORY 
If this parameter is set to the name of a writable file, the shell appends interactive input to 
the file, for use by the = command (=(1)). 

PS1 Primary prompt string, by default ‘‘$ ’’. 

PS2 Secondary prompt string, by default “‘> ”’. 

IFS Internal field separators, normally space, tab, and new-line. 


The shell gives default values to PATH, PS1, PS2 and IFS. HOME is set by login(8). 


Blank Interpretation 


After parameter and command substitution, the results of substitution are scanned for internal field separa- 
tor characters (those found in IFS) and split into distinct arguments where such characters are found. 
Explicit null arguments (''"' or 77) are retained. Implicit null arguments (those resulting from parameters 
that have no values) are removed. 


File Name Generation 


Following substitution, each command word is scanned for the characters *, ?, and [. If one of these char- 
acters appears the word is regarded as a pattern. The word is replaced with alphabetically sorted file names 
that match the pattern. If no file name is found that matches the pattern, the word is left unchanged. The 
directories . and .. (initially or after a /) are only matched by patterns beginning with an explicit period. The 
character / itself must be matched explicitly. 


Quoting 


* 


Matches any string, including the null string. 

Matches any single character. 

Matches any one of the enclosed characters. A pair of characters separated by — matches 
any character lexically between the pair, inclusive. If the first character following the 
opening ‘‘[’’ isa any character not enclosed is matched. 


66AD9 


The following characters have a special meaning to the shell and cause termination of a word unless 


quoted: 


; & () | <> new-line space tab { } 


(The characters { and } need not be quoted inside a ${} construction.) A character may be quoted (ic., 
made to stand for itself) by preceding it with a \. The pair \new-line is ignored. All characters enclosed 
between a pair of single quote marks (77), except a single quote, are quoted. Inside double quote marks 
(‘'''), parameter and command substitution occurs and \ quotes the characters \, +, ", and $. '"$*" is equiva- 
lent to ''$1 $2 ...", whereas "$@" is equivalent to "$1" "$2" .... 


Prompting 


When used interactively, the shell prompts with the value of PS1 before reading a command. If at any time 
a new-line is typed and further input is needed to complete a command, the secondary prompt (i.e., the 
value of PS2) is issued. 


Input/Output 


Before a command is executed, its input and output may be redirected using a special notation interpreted 
by the shell. The following may appear anywhere in a simple-command or may precede or follow a 
command and are not passed on to the invoked command; substitution occurs before word or digit is used: 


<word 
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>word Use file word as standard output (file descriptor 1). If the file does not exist it is created; 
otherwise, it is truncated to zero length. 

>>word Use file word as standard output. If the file exists output is appended to it (by first seek- 
ing to the end-of-file); otherwise, the file is created. 

<word The shell input is read up to a line that is the same as word, or to an end-of-file. The 


resulting document becomes the standard input. If any character of word is quoted, no 
interpretation is placed upon the characters of the document; otherwise, parameter and 
command substitution occurs, (unescaped) \new-line is ignored, and \ must be used to 
quote the characters \, $, s, and the first character of word. 


<&digit Use the file associated with file descriptor digit as standard input. Similarly for the stan- 
dard output using >&digit. 
<& The standard input is closed. Similarly for the standard output using >&-. 


If any of the above is preceded by a digit, the file descriptor which will be associated with the file is that 
specified by the digit (instead of the default 0 or 1). For example: 


... 2>&1 
associates file descriptor 2 with the file currently associated with file descriptor 1. 


The order in which redirections are specified is significant. The shell evaluates redirections left-to-right. 
For example: 


... L>xxx 2>&1 


first associates file descriptor 1 with file xxx. It associates file descriptor 2 with the file associated with file 
descriptor | (i.e. xxx). If the order of redirections were reversed, file descriptor 2 would be associated with 
the terminal (assuming file descriptor 1 had been) and file descriptor 1 would be associated with file xxx. 


If a command is followed by & the default standard input for the command is the empty file /dev/null. 
Otherwise, the environment for the execution of a command contains the file descriptors of the invoking 
shell as modified by input/output specifications. 


Environment 


The environment (see environ(5)) is a list of name-value pairs that is passed to an executed program in the 
same way as a normal argument list. The shell interacts with the environment in several ways. On invoca- 
tion, the shell scans the environment and creates a parameter or function for each name found, giving it the 
corresponding value. If the user modifies the value of any of these parameters or creates new parameters, 
none of these affects the environment unless the export command is used to bind the shell’s parameter to 
the environment (see also set -a). A parameter may be removed from the environment with the unset com- 
mand. The environment seen by any executed command is thus composed of any unmodified name-value 
pairs originally inherited by the shell, minus any pairs removed by unset, plus any modifications or addi- 
tions, all of which must be noted in export commands. 


The environment for any simple-command may be augmented by prefixing it with one or more assignments 
to parameters (but not functions). Thus: 


TERM=450 cmd and 
(export TERM; TERM=450; cmd) 
are equivalent (as far as the execution of cmd is concerned). 


If the -k flag is set, all keyword arguments are placed in the environment, even if they occur after the com- 
mand name. The following first prints a=b c then c: 


echo a=b c 
set —k 
echo a=b c 


Signals 


The INTERRUPT and QUIT signals for an invoked command are ignored if the command is followed by &; 
otherwise signals have the values inherited by the shell from its parent, with the exception of signal 11 (but 
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see also the trap command below). 


Execution 


Each time a command is executed, the above substitutions are carried out. If the command name matches 
one of the Special Commands listed below, it is executed in the shell process. If the command name does 
not match a Special Command , but matches the name of a defined function, the function is executed in the 
shell process (note how this differs from the execution of shell procedures). The positional parameters $1, 
$2, .... are set to the arguments of the function. If the command name matches neither a Special 
Command nor the name of a defined function, a new process is created and an attempt is made to execute 
the command via exec(2). 


The shell parameter PATH defines the search path for the directory containing the command. Alternative 
directory names are separated by a colon (:). The default path is :/bin:/usr/bin (specifying the current 
directory, /bin, and /usr/bin, in that order). Note that the current directory is specified by a null path name, 
which can appear immediately after the equal sign or between the colon delimiters anywhere else in the 
path list. If the command name contains a / the search path is not used. Otherwise, each directory in the 
path is searched for an executable file. If the file has execute permission but is not an a.out file, it is 
assumed to be a file containing shell commands. A sub-shell is spawned to read it. A parenthesized com- 
mand is also executed in a sub-shell. 


Special Commands 
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Input/output redirection is permitted for these commands. File descriptor 1 is the default output location. 


No effect; the command does nothing. A zero exit code is returned. 

. file Read and execute commands from file and return. The search path specified by PATH is used to 
find the directory containing file. 

builtin [ command | 
Execute the built-in special command (such as break) regardless of functions defined with the 
same name. 

break [ 7 | 
Exit from the enclosing for or while loop, if any. If n is specified break n levels. 

continue [ 7 | 
Resume the next iteration of the enclosing for or while loop. If is specified resume at the n-th 
enclosing loop. 

ed [ arg ] 
Change the current directory to arg. The shell parameter HOME is the default arg. The shell 
parameter CDPATH defines the search path for the directory containing arg. Alternative directory 
names are separated by a colon (:). The default path is <null> (specifying the current directory). 
Note that the current directory is specified by a null path name, which can appear immediately 
after the equal sign or between the colon delimiters anywhere else in the path list. If arg begins 
with a/ the search path is not used. Otherwise, each directory in the path is searched for arg. 

eval [ arg... ] 
The arguments are read as input to the shell and the resulting command(s) executed. 

exec [ arg... | 
The command specified by the arguments is executed in place of this shell without creating a new 
process. Input/output arguments may appear and, if no other arguments are given, cause the shell 
input/output to be modified. 

exit [ 7 |] 
Causes a shell to exit with the exit status specified by n. If n is omitted the exit status is that of the 
last command executed (an end-of-file will also cause the shell to exit.) 

export [ name... | 
The given names are marked for automatic export to the environment of subsequently-executed 
commands. If no arguments are given, a list of all names that are exported in this shell is printed. 

newgrp [ arg... | 
Equivalent to exec newgrp arg .... See newgrp(1) for usage and description. 
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read [ name... | 


One line is read from the standard input and the first word is assigned to the first name, the second 
word to the second name, etc., with leftover words assigned to the last name. The return code is 0 
unless an end-of-file is encountered. 


return [ 7 | 


Causes a function to exit with the return value specified by n. If n is omitted, the return status is 
that of the last command executed. 


set [| —aehknptuvx [ arg... ] ] 


-a Mark variables which are modified or created for export. 

-e Exit immediately if a command exits with a non-zero exit status. 

-f Disable file name generation 

-k All keyword arguments are placed in the environment for a command, not just those that 
precede the command name. 

—n Read commands but do not execute them. 

-p Remove the definitions for all functions imported from the environment, and set IFS to 
blank, tab and newline. 

-t Exit after reading and executing one command. 

-u Treat unset variables as an error when substituting. 

-V Print shell input lines as they are read. 

-x Print commands and their arguments as they are executed. 


— Do not change any of the flags; useful in setting $1 to -. 

Using + rather than — causes these flags to be turned off. These flags can also be used upon invo- 
cation of the shell. The current set of flags may be found in $-. The remaining arguments are 
positional parameters and are assigned, in order, to $1, $2, .... If no arguments are given the val- 
ues of all names are printed. 


shift [7 ] 
The positional parameters from $n+1... are renamed $1 .... If 7 is not given, it is assumed to be 
1. 

times 


Print the accumulated user and system times for processes run from the shell. 


trap[ arg ][ 7 ]... 


The command arg is to be read and executed when the shell receives signal(s) n. (Note that arg is 
scanned once when the trap is set and once when the trap is taken.) Trap commands are executed 
in order of signal number. Any attempt to set a trap on a signal that was ignored on entry to the 
current shell is ineffective. An attempt to trap on signal 11 (memory fault) produces an error. If 
arg is absent all trap(s) n are reset to their original values. If arg is the null string this signal is 
ignored by the shell and by the commands it invokes. If n is 0 the command arg is executed on 
exit from the shell. The trap command with no arguments prints a list of commands associated 
with each signal number. 


umask [ nnn | 


The user file-creation mask is set to nnn (see umask(2)). If nnn is omitted, the current value of the 
mask is printed. 


unset [ name... | 


For each name, remove the corresponding variable or function. The variables PATH, PS1, PS2 and 
IFS cannot be unset. 


wait [ n | 


Wait for the specified process and report its termination status. If n is not given all currently 
active child processes are waited for and the return code is zero. 


whatis [ name... | 


For each name, print the associated value as a parameter, function, builtin or executable binary as 
appropriate. In each case, the value is printed in a form that would yield the same value if typed as 
input to the shell itself: parameters are printed as assignments, functions as their definitions, buil- 
tins as calls to builtin, and binaries as their full pathnames. 
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Invocation 
If the shell is invoked through exec(2) and the first character of argument zero is —, commands are initially 
read from $HOME/.profile, if it exists. Thereafter, commands are read as described below, which is also 
the case when the shell is invoked as /bin/sh. The flags below are interpreted by the shell on invocation 
only; Note that unless the —c or —-s flag is specified, the first argument is assumed to be the name of a file 
containing commands, and the remaining arguments are passed as positional parameters to that command 
file: 


-c string If the -c flag is present commands are read from string. 

-s If the -s flag is present or if no arguments remain commands are read from the standard input. 
Any remaining arguments specify the positional parameters. Shell output (except for Special 
Commands ) is written to file descriptor 2. 

-i If the -i flag is present or if the shell input and output are attached to a terminal, this shell is 
interactive. In this case TERMINATE is ignored (so that kill 0 does not kill an interactive shell) 
and INTERRUPT is caught and ignored (so that wait is interruptible). In all cases, QUIT is 
ignored by the shell. 


The remaining flags and arguments are described under the set command above. 


EXIT STATUS 
Errors detected by the shell, such as syntax errors, cause the shell to return a non-zero exit status. If the 
shell is being used non-interactively execution of the shell file is abandoned. Otherwise, the shell returns 
the exit status of the last command executed (see also the exit command above). 


FILES 
$HOME/. profile 
/tmp/sh* 
/dev/null 

SEE ALSO 


=(1), cd(1), echo(1), newgrp(1), test(1) 
dup(2), exec(2), fork(2), pipe(2), signal(2), umask(2), wait(2), a.out(5), environ(5) 


BUGS 
A function invocation overwrites the arguments of the invoking shell. 
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NAME 
ship — automatic software distribution 

SYNOPSIS 
ship files 

DESCRIPTION 
Ship distributes the named files to other computers, where they are installed under the same names. The 
shipper must be registered in the tables of asd(5). Ship will ask for a key to confirm the shipper’s rights. 
Links among the named files are imitated on the receiving computer. Named files that do not exist on the 
sending computer are deleted on the receiving computer. 

SEE ALSO 


asd(8), asd(5) 
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NAME 
size — size of an object file 
SYNOPSIS 
size [ object ... ] 
DESCRIPTION 
Size prints the (decimal) number of bytes required by the text, data, and bss portions, and their sum in hex 
and decimal, of each object-file argument. If no file is specified, a.out is used. 
SEE ALSO 


a.out(5), nm(1) 
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NAME 
sleep — suspend execution for an interval 
SYNOPSIS 
sleep time 
DESCRIPTION 
Sleep suspends execution for time seconds. It is used to execute a command after a certain amount of time 
as in: 
(sleep 105; command)& 
or to execute a command every so often, as in: 
while true 
do 
command 
sleep 37 
done 
SEE ALSO 
alarm(2), sleep(3) 
BUGS 


Time must be less than 2147483647 seconds. 
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NAME 
sno — Snobol language interpreter 


SYNOPSIS 
sno [ files ] 


DESCRIPTION 
Sno is a SNOBOL3 (with slight differences) compiler and interpreter. Sno obtains input from the concate- 
nation of the named files and the standard input. All input through a statement containing the label end is 
considered program and is compiled. The rest is available to syspit. 


Sno differs from SNOBOL3 in the following ways: 
There are no unanchored searches. To get the same effect: 


a ** b unanchored search for b. 
a*x* b= xc unanchored assignment 


There is no back referencing. 


x cnt "abc" 
a *x* X is an unanchored search for abe. 


Function declaration is done at compile time by the use of the (non-unique) label define. Execu- 
tion of a function call begins at the statement following the define. Functions cannot be defined at 
run time, and the use of the name define is preempted. There is no provision for automatic vari- 
ables other than parameters. Examples: 


define f( ) 
define f(a, b, c) 


All labels except define (even end) must have a non-empty statement. 


Labels, functions and variables must all have distinct names. In particular, the non-empty state- 
ment on end cannot merely name a label. 


If start is a label in the program, program execution will start there. If not, execution begins with 
the first executable statement; define is not an executable statement. 


There are no builtin functions. 


Parentheses for arithmetic are not needed. Normal precedence applies. Because of this, the arith- 
metic operators / and * must be set off by spaces. 


The right side of assignments must be non-empty. 
Either ’ or " may be used for literal quotes. 
The pseudo-variable sysppt is not available. 


SEE ALSO 
spitbol(1), snocone(1), awk(1) 
““SNOBOL, a String Manipulation Language,’’ by D. J. Farber, R. E. Griswold, and I. P. Polonsky, JACM 
11 (1964), pp. 21-30. 
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NAME 

snocone — snobol with syntactic sugar 
SYNOPSIS 

snocone file ... 
DESCRIPTION 
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Snocone is a programming language, syntactically similar to C, that compiles into SNOBOL4. The Sno- 
cone compiler translates the concatenation of all the input files into a SNOBOL4 program, which it writes 
in a.out. The first line of a.out arranges that if a.out is executed, the SNOBOL4 interpreter will automati- 
cally be invoked. 


A synopsis of the Snocone syntax follows. 


Lexical conventions 
Everything after the first # on an input line is ignored. 
Statements normally end at the end of the line. If the last character on a line is an operator, open 
parenthesis or bracket, or comma, the statment is continued on the next line. 
Spaces generally follow C conventions. 


Binary operators (grouped by decreasing precedence): 


$. conditional and immediate pattern value assignment, as in SNOBOL4 
power; right-associative as in SNOBOL4 

*/1% 
multiplication, division, remainder; unlike SNOBOL4, all have the same precedence. 

+-— addition, subtraction 

<> <= De se [= i: i>: s<=i spat rear tle: 
comparison operators; the ones surrounded by colons do character comparisons, the others do 
numeric comparisons. These operators behave as SNOBOL4 predicates: they return the null string if 
the indicated condition is true, and fail if it is false. 

&& concatenation; evaluates its right operand only after its left operand has been successfully evaluated. 
It therefore acts as logical and when applied to predicates. The null string may be concatenated to 
any value. 

|| the value of the left operand if possible, otherwise the value of the right operand. Behaves as logical 
or when applied to predicates. 

| pattern value alternation. 

2 pattern match. Returns the part of the left operand matched by the right operand, which must be a 
pattern. May be used on the left of an assignment if the left operand is appropriate. Right- 
associative. 

7 assignment 


Unary operators; all map to their SNOBOL4 equivalents and have the same (highest) precedence. 


+ The numeric equivalent of its argument. 
- The numeric equivalent of its argument, with the sign reversed. 
* Unevaluated expression, as in SNOBOL4. 
$ If v is a value of type name, then $v is the variable of that name. 
@ Pattern matching cursor assignment. 
> Logical negation: returns the null string if its argument fails, and fails otherwise. 
? Returns the null string if its argument succeeds, and fails otherwise. 
Returns a value of type 
name that refers to its (value) argument. 


Statements 


Statements may be prefixed by one or more labels. A label is an identifier followed by a colon, as in C. All 
labels are global: it is a good idea to begin labels in procedures with the name of the procedure. 


SNOCONE (1) Eighth Edition SNOCONE(1) 


BUGS 


expression 
The given expression is evaluated for its side effects. 


{ statement ... } 
The statements are executed sequentially. 


if (expression) statement [ else statement | 
If evaluation of the expression succeeds, the first statement is executed. Otherwise, the second 
statement, if any, is executed. An else belongs to the closest unmatched if. 


while (expression) statement 
The statement is executed repeatedly, as long as the expression can be successfully evaluated. 


do statement while (expression) 
Like the while statement, except that the statement is executed once before the first time the 
expression is evaluated. 


for (el, e2, e3) statement 
As in C, except that commas are used instead of semicolons. 


return [expression] 
returns the value of the expression from the current function. If expression fails or is missing, the 
value returned is that of the variable with the same name as the function. If that variable was 
never set, the function returns the null string. 


nreturn [expression] 
The expression must be the name of a variable. That variable is returned from the current function 
as an lvalue. If the expression fails or is missing, the variable with the same name as the function 
must have been set to the name of a variable. 


freturn The current function returns failure. 


goto label 
Transfer control to the given label. 


Procedures may not be textually nested, but may be recursive and may call each other in forward refer- 
ences. The general form of a procedure declaration is: 


procedure name (args) locals { statement ... } 


The args and locals are lists of variable names, separated by commas. Since Snocone is a dynamically 
typed language, further declarations are not necessary. Although procedures are not textually nested, names 
are dynamically scoped: a procedure can reference the local variables and parameters of its caller as if they 
were global variables. 


Assigning a (string) value to the variable output causes that value to be written as a single line on the stan- 
dard output. Accessing the variable input causes a line to be read from the standard input. The access fails 
at end of file. Accessing or assigning to the variable terminal causes a line to be read from or written to the 
standard error file. Other input-output is as implemented by the Macrospitbol interpreter (see spitbol(1)). 


Run-time diagnostics refer to SNOBOL4 source statement numbers, not to Snocone line numbers. 
Extremely long statements can overflow the SNOBOL4 compiler’s limits on input line length. 
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NAME 


sort — sort and/or merge files 


SYNOPSIS 


sort [ -cmuMbdfinrtx | [ +pos1 [ -pos2 ] ] ... [ -o output ] [-ymemory ] [ -zrecsize ] [ names ] 


DESCRIPTION 


Sort sorts lines of all the named files together and writes the result on the standard output. The name — 
means the standard input. If no input files are named, the standard input is sorted. 


The default sort key is an entire line. Default ordering is lexicographic by bytes in machine collating 
sequence. The ordering is affected globally by the following options, one or more of which may appear. 


M ~~ Compare as months. The first three non-blank characters of the field are folded to lower case and 
compared so that ‘jan’ < ‘feb’ <...< ‘dec’. Invalid fields compare low to ‘jan’. 


b Ignore leading blanks (spaces and tabs) in field comparisons. 

d ‘Dictionary’ order: only letters, digits and blanks are significant in comparisons. 

f Fold upper case letters onto lower case. 

i Ignore characters outside the ASCII range 040-0176 in non-numeric comparisons. 

n An initial numeric string, consisting of optional blanks, optional minus sign, and zero or more digits 
with optional decimal point, is sorted by arithmetic value. Option n implies option b. 

r Reverse the sense of comparisons. 

tx “Tab character’ separating fields is x. 


The notation +pos1 —pos2 restricts a sort key to a field beginning at pos] and ending just before pos2. 
PosI and pos2 each have the form m.n, optionally followed by one or more of the flags Mbdfinr, where m 
tells a number of fields to skip from the beginning of the line and n tells a number of characters to skip fur- 
ther. If any flags are present they override all the global ordering options for this key. If the b option is in 
effect n is counted from the first non-blank in the field; b is attached independently to pos2. A missing .n 
means .0; a missing —pos2 means the end of the line. Under the -tx option, fields are strings separated by 
x; otherwise fields are non-empty non-blank strings separated by blanks. The blanks separating fields are 
considered the first characters in the field. 


When there are multiple sort keys, later keys are compared only after all earlier keys compare equal. Lines 
that otherwise compare equal are ordered with all bytes significant. 


These option arguments are also understood: 


c Check that the single input file is sorted according to the ordering rules; give no output unless the file 
is out of sort. 


m Merge only, the input files are already sorted. 


u Suppress all but one in each set of equal lines. Ignored bytes and bytes outside keys do not partici- 
pate in this comparison. 


(0) The next argument is the name of an output file to use instead of the standard output. This file may 
be the same as one of the inputs. 


ymemory 
Suggests the use of the specified number of bytes of internal store in hopes of tuning performance; 0 
is appropriate for very small files, a missing number for huge ones. 


zrecsize 
provide for abnormally large records; useful only with -c and -m 


EXAMPLES 
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sort —u +Of +0 list 
Print in alphabetical order all the unique spellings in a list of words where capitalized words differ 
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from uncapitalized. 


sort -t: +2n /etc/passwd 
Print the password file (passwd (5)) sorted by userid (the third colon-separated field). 


sort -umM dates 
Print the first instance of each month in an already sorted file. Options -um with just one input 
file make the choice of a unique representative from a set of equal lines predictable. 


FILES 
/usr/tmp/stm??? 
SEE ALSO 
comm(1), join(1), uniq(1). 
DIAGNOSTICS 
Comments and exits with non-zero status for various trouble conditions and for disorder discovered under 
option —c. 
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NAME 


spell — find spelling errors 


SYNOPSIS 


spell [ option ] ... [ file] ... 


DESCRIPTION 


FILES 


Spell looks up words from the named files (standard input default) in a public spelling list and in a private 
list. Words that occur in neither and are not plausibly derivable from words in the public list are placed on 
the standard output. 


Spell ignores most troff, tbl, pic, and eqn(1) constructions. It understands these options: 
—-b check British spelling 

-v print all words not literally in the spelling list, with derivations 

-x print, marked with ‘=’, every stem tried in both stop list and spelling list 

The private list, by default $HOME/lib/spelldict, is arranged one word per line. 


Pertinent auxiliary files may be specified by environment variables, indicated below with their default set- 
tings. Copies of all output are accumulated in the history file, if itis writable. The stop list filters out mis- 
spellings (e.g. thier=thy—y+ier) that would otherwise pass. 


D_SPELL=/usr/dict/hlist[ab]: hashed public lists, American & British 
S_SPELL=/usr/dict/hstop: hashed stop list 
H_SPELL=/usr/dict/spellhist: history file 
A_SPELL=$HOME/lib/spelldict: private list 
P_SPELL=/usr/lib/spell: the main routine 

deroff(1), sort(1), tee(1), comm(1) 


SEE ALSO 


BUGS 
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dict(7) 


A malicious opponent can defeat spell’s heuristics for word derivation, but this rarely happens in practice. 
The spelling list’s coverage is uneven; in particular biology, medicine, and chemistry are covered very 
lightly. New installations will probably wish to monitor the output for several months to gather local addi- 
tions. 

British spelling was done by an American. 
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NAME 


spitbol — Snobol language compiler 


SYNOPSIS 


spitbol [ options ] ifile ... 


DESCRIPTION 
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Spitbol is an upward compatible dialect of SNOBOL4. 


All names used in a program are normally mapped to UPPER CASE during compilation and execution. For 
strict compatibility with SNOBOL4, use the -f option or -CASE control statement. 


All ifiles are read in order before the standard input. Standard output comes only from assignments to 
OUTPUT and from error messages. 


Compiler options: 


-f don’t fold lower case names to UPPER CASE 
-e don’t send error messages to the terminal 

-l generate source listing 

—c generate compilation statistics 

-x generate execution statistics 

-a like -Iex 

-p long listing format; generates form feeds 

-Z use standard listing format 

—-h write spitbol header to standard output 

—n suppress execution 


-mdd max size (words) of created object (default 8192) 

-sdd maximum size (words) of stack space (default 2048) 

-idd size (words) of increment by which dynamic area is increased (default 4096) 
—ddd size (words) of maximum allocated dynamic area (default 256K) 


-u string 
executing program may retrieve string with HOST(0) 


-0 ofile write listing, statistics and dump to ofile and OUTPUT to standard output 
Note: dd can be followed by a k to indicate units of 1024. 


Spitbol has two input-output modes, line mode, where records are delimited by new-line characters, and 
raw mode where a predetermined number of bytes is transferred. Modes are specified in INPUT or OUT- 
PUT function calls. The maximum length of an input record is set by the -I or -r argument. The form of 
the INPUT/OUTPUT function call is 


INPUT/OUTPUT(.name,channel, file name args) 


where name is the variable name to be input/output associated and channel is an integer or string that 
identifies the association to be used in subsequent calls for EJECT, ENDFILE, INPUT, OUTPUT, 
REWIND, and SET. If the channel is omitted or the null string, the association is made to the system’s 
standard input or output stream. file name args specifies the source/destination of the input/output and any 
IO processing arguments. The file_name can be either a path name to a file or a command string. Command 
strings are distinguished from file names by a leading "!". The character following the is the delimiter 
used to separate the command string from any IO processing arguments. The ending delimiter may be omit- 
ted if there are no IO processing arguments. There must always be at least one space between the file_name 
and args, even if the file_name is null. 


myn 
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Input/output arguments are: 


-a Append output to existing file. If file doesn’t exist then it is created. If —a is not specified then file 
is created. 


-bdd Set internal buffer size to dd characters. This value is the byte count used on all input/output trans- 
fers except for the last write to an output file (default 1024). 


—C Like -r/ 


-fdd Use dd as file desciptor for IO. spitbol assumes that dd has been opened by the shell. File names 
and -fdd arguments are mutually exclusive. File descriptors 0, 1, and 2 may be accessed in this 
manner. 


—-Idd Line mode: maximum input record length is dd characters (default 1024). 
-rdd Raw mode: input record length is dd characters. 


-w On output, each record is directly written to the file without any intermediate buffering (default for 
terminals). On input, each input operation uses exactly one read(2), and fails if read returns 0. 


More than one type of transfer may be associated with a channel. This is accomplished by calling 
INPUT/OUTPUT after the initial call with the name, channel, and file arguments. The file name or -f argu- 
ment must not be specified on calls subsequent to the first. 


Standard functions: SET(channel,integer,integer) The arguments are same as those to the /seek(2), escept 
that the first argument identifies a spitbol channel instead of a file descriptor. 


EXIT(command-string) 
causes the value of command-string to be handed to the Shell to be executed after spitbol termi- 
nates. 

EXIT(n) 
If n is greater than 0, a load module will be written in a.out before termination. Executing this 
load module will restore the state of the spitbol system to what it was when EXIT was called, 
except that any files other than the standard input, output, and error will have been closed. To the 
SNOBOL4 program, it will appear as if EXIT had returned a null string. If n is exactly 1, the gen- 
erated load module will identify the version of spitbol that created it in a message when it begins 
execution. If is greater than 1, it will resume quietly. 


HOSTO returns the host string read from /usr/lib/spithost. 


HOST(0) 
returns the string specified with the —u option on the command line. If -u was not specified the 
null string is returned. 


HOST (1,"command string") 

executes the command string and continues. 
HOST(2,n) 

returns argument number n from the command line. It fails if n is out of range or not an integer. 
HOST(3) 

returns the index of the first command line argument that was not examined by spitbol. 
HOST(4,"var" 


returns the value of the environment variable var. If the value is too long for an internal buffer 
(presently 512 bytes) it is quietly truncated. 


MISCELLANY 
A file is not actually opened until the first attempt to read, write, SET, or REWIND it. 


Folding of names to UPPER CASE can be controlled during compilation by the -CASE control statement 
and during execution by the &CASE keyword. A value of 0 prevents folding to UPPER CASE and a value 
of 1 forces folding to UPPER CASE. 
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FILES 


Integers are represented by 32-bit quantities. Real numbers are implemented in single precision. 


Setting &STLIMIT = -1 inhibits statement limit checking and provides a way to execute arbitrarily many 
statements. 


The name TERMINAL is available with default associations for input and output to the terminal. 


If the first line of the first input file begins with #! then that line is ignored. This meshes with the way that 
exec(2) treats files beginning with #!. 


Setting &PROFILE = 1 causes spitbol to accumulate profile information during program execution and 
print this information after the program terminates. 


/usr/lib/vaxspitv35.err — Error text. 
/usr/lib/spithost — Host computer and operating system identifier. 


SEE ALSO 
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Macro SPITBOL Program Reference Manual by R. B. K. Dewar, A. P. McCann, R. E. Goldberg, and 
Steven G. Duff 

The SNOBOL4 Programming Language, Second Edition by R. E. Griswold, J. F. Poage and I. P. Polonsky 
sno(1), snocone(1) 
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NAME 


split, fsplit — split a file into pieces 


SYNOPSIS 


split [ -n | -e expression ] [ -f fileroot ] [ —x ] [ -y ] [-s suffix ] [ file ] 
fsplit [ option ] ... [ file ] ... 


DESCRIPTION 


Split reads file (standard input by default) and writes it in n-line pieces (default 1000), as many as neces- 
sary, onto a set of output files. The name of the first output file is fileroot (default x) with aa appended, and 
so on lexicographically. 


If one or more expressions are specified, the file divisions occur at each line of file which matches an 
expression; line counts are irrelevant. The expressions are identical to those of grep(1). If a subexpression 
of expression is contained in escaped parentheses \(...\), the file name for the output file is the portion of the 
line which matches the subexpression, optionally suffixed by a string specified with the —-s option. 


The first line of each output file is the matching input line, but it may be excluded from the output file by 
setting the —x flag. The —y flag causes lower case letters in expression to match either case of letter in the 
input, but any output file names (excluding the suffix) will be forced to lower case. 


F split splits a collection of Fortran subprograms in one file into separate files. Options -f, -e, and -r set the 
file suffix: procedure ‘proc’ will go into file ‘proc.f (default), ‘proc.e’, or ‘proc.r’ accordingly. Block data 
subprograms will go into files named ‘BLOCKDATAL +’, etc. 


Option —s strips off data beyond column 72 together with any resulting trailing blanks. 


SEE ALSO 


Page | 


sed(1), awk(1) 
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NAME 


strip — remove symbols and relocation bits 


SYNOPSIS 


strip [-s ] [-g ] [-v ] name... 


DESCRIPTION 


FILES 


Strip removes the symbol table and relocation bits ordinarily attached to the output of the assembler and 
loader. This is useful to save space after a program has been debugged. 


If -s is specified, the symbol table is compressed by removing duplicate structure definitions and symbol 
table entries; no information is lost. If -g is specified, all line-number information is deleted, thus inverting 
the effect of “cc -g’; -s compression is performed as well. The —v flag prints out size information. If no 
flags are given, strip removes the symbol table entirely; this is the same as use of the -s option of /d(1). 


shrink? temporary file 


SEE ALSO 
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cc(1), Id(1) 
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NAME 


DESCRIPTION 
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struct — structure Fortran programs 


SYNOPSIS 
struct [ option ] ... file 


Struct translates the Fortran program specified by file (standard input default) into a Ratfor program. Wher- 
ever possible, Ratfor control constructs replace the original Fortran. Statement numbers appear only where 
still necessary. Cosmetic changes are made, including changing Hollerith strings into quoted strings and 
relational operators into symbols (e.g. ".GT." into ">"). The output is appropriately indented. 


The following options may occur in any order. 


-s Input is accepted in standard format, i.e. comments are specified by ac, C, or * in column 1, and 
continuation lines are specified by a nonzero, nonblank character in column 6. Normally input is 
in the form accepted by f77(1) 

-i Do not turn computed goto statements into switches. (Ratfor does not turn switches back into 
computed goto statements.) 

-a Turn sequences of else ifs into a non-Ratfor switch of the form 
switch 

{ case pred1: code 
case pred2: code 
case pred3: code 
default: code 
} 
The case predicates are tested in order; the code appropriate to only one case is executed. This 
generalized form of switch statement does not occur in Ratfor. 

-b Generate goto’s instead of multilevel break statements. 

—n Generate goto’s instead of multilevel next statements. 

-tn Make the nonzero integer n the lowest valued label in the output program (default 10). 

-cn Increment successive labels in the output program by the nonzero integer n (default 1). 

-en If n is 0 (default), place code within a loop only if it can lead to an iteration of the loop. If n is 
nonzero, admit a small code segments to a loop if otherwise the loop would have exits to several 
places including the segment, and the segment can be reached only from the loop. ‘Small’ is close 
to, but not equal to, the number of statements in the code segment. Values of n under 10 are sug- 
gested. 

FILES 

/tmp/struct* 

/usr/lib/struct/* 
SEE ALSO 

f77(1), ratfor(1) 
BUGS 
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Struct knows Fortran 66 syntax, but not full Fortran 77. 

If an input Fortran program contains identifiers which are reserved words in Ratfor, the structured version 
of the program will not be a valid Ratfor program. 

The labels generated cannot go above 32767. 

If you get a goto without a target, try -e. 
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NAME 

stty — set terminal options 
SYNOPSIS 

stty [ option ... ] 
DESCRIPTION 
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Stty sets certain I/O options for the terminal open on /dev/tty (file descriptor 3). With no argument, it 
reports the current settings of the options. The options are: 


even 
—even 
odd 
-—odd 
raw 
-raw 
cooked 
cbreak 
—cbreak 
—nl 

nl 

echo 
-echo 
Icase 
—Icase 
—tabs 
tabs 

ek 
erase c 


kill c 
intr c 
quit c 
stop c 
start c 
eof c 
brk c 


allow even parity 

disallow even parity 

allow odd parity 

disallow odd parity 

raw mode input (no erase, kill, interrupt, quit, EOT; parity bit passed back) 
negate raw mode 

same as ‘raw’ 

make each character available to read(2) as received; no erase and kill 
make characters available to read only when newline is received 

allow carriage return for new-line, and output CR-LF for carriage return or new-line 
accept only new-line to end lines 

echo back every character typed 

do not echo characters 

map upper case to lower case 

do not map case 

replace tabs by spaces when printing 

preserve tabs 

reset erase and kill characters back to normal # and @ 


set erase character to c (initially ‘#’) In this and other character-setting options a ‘~’ may pre- 


cede c to signify control-c. 

set kill character to c (initially “@’) 

set interrupt character to c (initially DEL) 

set quit character to c (initially “\’) 

set stop character to c (initially ‘*S’) 

set start character to c (initially ““Q’) 

set ‘end of file’ character to c (initially ““D’) 

set ‘line-break’ character to c (initially undefined) 


cr0 crl1 cr2 cr3 


select style of delay for carriage return (see ioctl(2)) 


nl0 nll nl2 nl3 


select style of delay for linefeed 


tab0 tab1 tab2 tab3 


ff0 ff1 
bs0 bs1 
tty33 
tty37 
vt05 
tn300 
ti700 
tek 
hup 
—hup 
0 


select style of delay for tab 

select style of delay for form feed 

select style of delay for backspace 

set all modes suitable for the Teletype Corporation Model 33 terminal. 
set all modes suitable for the Teletype Corporation Model 37 terminal. 
set all modes suitable for Digital Equipment Corp. VTOS5 terminal 

set all modes suitable for a General Electric TermiNet 300 

set all modes suitable for Texas Instruments 700 series terminal 

set all modes suitable for Tektronix 4014 terminal 

hang up dataphone on last close. 

do not hang up dataphone on last close. 

hang up phone line immediately 
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50 75 110 134 150 200 300 600 1200 1800 2400 4800 9600 exta extb 
Set terminal baud rate to the number given, if possible. 


SEE ALSO 
ttyld(4), ioctl(2), tabs(1) 
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NAME 
sum — sum and count blocks in a file 
SYNOPSIS 
sum [ file ] ... 
DESCRIPTION 
Sum calculates and prints a 16-bit checksum along with the length (in blocks) and name of each file. If no 
files are given, the standard input is summed. If file is “—’, file names are read from standard input. 
Sum is typically used to look for bad spots, or to validate a file communicated over some transmission line. 
SEE ALSO 
we(1). 
DIAGNOSTICS 


‘Read error’ is indistinguishable from end of file on most devices; check the byte count. 
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NAME 
tabs — set terminal tabs 


SYNOPSIS 
tabs [+mnum ] [ —-Tterm ] 


DESCRIPTION 
Tabs sets the tabs on a variety of terminals. Term is a name given in term(7). The name may also be sup- 
plied by the environment variable TERM. 


The +n option offsets the left margin n positions. 


SEE ALSO 
stty(1), term(7), tset(1) 
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NAME 
tail — deliver the last part of a file 


SYNOPSIS 
tail [ tnumber[Ibe][fr] ] [ file ] 


DESCRIPTION 
Tail copies the named file to the standard output beginning at a designated place. If no file is named, the 
standard input is used. 


Copying begins at distance +number from the beginning, or —number from the end of the input. Number is 
counted in units of lines, 1K blocks or characters, according to the appended option I, b or c. When no units 
are specified, counting is by lines. 


Option r causes tail to print lines from the end of the file in reverse order. Option f (follow) causes tail not 
to stop at the end, and to watch for further data to appear. 

SEE ALSO 
dd(1) 


BUGS 
Tails relative to the end of the file are treasured up in a buffer, and thus are limited in length. 
Various kinds of anomalous behavior may happen with character special files. 
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NAME 

tape, mt — identify and manipulate magnetic tape 
SYNOPSIS 

tape 


mt [ -t tapename ] command [ count ] 


DESCRIPTION 
Tape experiments with the magnetic tape drive and reports under which device name the tape mounted 
there can be read, how many files and records there are, and how big the records are. Mt applies a 
command to the named tape drive (default /dev/nrmt1) count times (default 1). The commands are 


eof write end-of -file mark 
fsf forward space file 

fsr forwardspace record 
bsf _ backspace file 

bsr backspace record 


rewind 
rewind 
offline rewind and take off line 
FILES 
/dev/nrmt1 
SEE ALSO 


tm(4), dd(1) 
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NAME 
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tar — tape archiver 


SYNOPSIS 


tar [ key ] [name ... ] 


DESCRIPTION 
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Tar saves and restores files on magtape. Its actions are controlled by the key argument. The key is a string 
of characters containing at most one function letter and possibly one or more function modifiers. Other 
arguments to the command are file or directory names specifying which files are to be dumped or restored. 
In all cases, appearance of a directory name refers to the files and (recursively) subdirectories of that direc- 
tory. 


The function portion of the key is specified by one of the following letters: 


r The named files are written on the end of the tape. The c function implies this. Currently, this 
option does not work without the ¢ option. 


x The named files are extracted from the tape. If the named file matches a directory whose contents 
had been written onto the tape, this directory is (recursively) extracted. The owner and mode are 
restored (if possible). If no file argument is given, the entire content of the tape is extracted. 
Note that if multiple entries specifying the same file are on the tape, the last one overwrites all 
earlier. 


t The names of the specified files are listed each time they occur on the tape. If no file argument is 
given, all of the names on the tape are listed. 


u The named files are added to the tape if either they are not already there or have been modified 
since last put on the tape. 


c Create a new tape; writing begins on the beginning of the tape instead of after the last file. This 
command implies r. 


(0) On output, tar normally places information specifying owner and modes of directories in the 
archive. Former versions of tar, when encountering this information will give error message of 
the form 

"<name>/: cannot create". 
This option will suppress the directory information. 


p This option says to restore files to their original modes, ignoring the present umask(2). Setuid 
and sticky information will also be restored to the super-user. 


The following characters may be used in addition to the letter which selects the function desired. 
0,...,7 This modifier selects the drive on which the tape is mounted. The default is 1. 


v Normally tar does its work silently. The v (verbose) option causes it to type the name of each 
file it treats preceded by the function letter. With the t function, v gives more information 
about the tape entries than just the name. 


w causes far to print the action to be taken followed by file name, then wait for user confirmation. 
If a word beginning with ‘y’ is given, the action is performed. Any other input means don’t do 
it. 

f causes tar to use the next argument as the name of the archive instead of /dev/mt?. If the name 
of the file is ‘—’, tar writes to standard output or reads from standard input, whichever is appro- 
priate. Thus, tar can be used as the head or tail of a filter chain Tar can also be used to move 
hierarchies with the command 

cd fromdir; tar cf —. | (cd todir; tar xf —) 


b causes far to use the next argument as the blocking factor for tape records. The default is 1, the 
maximum is 20. This option should only be used with raw magnetic tape archives (See f 
above). 
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] tells tar to complain if it cannot resolve all of the links to the files dumped. If this is not 
specified, no error meesages are printed. 


FILES 
/dev/rmt? 
/tmp/tar* 
DIAGNOSTICS 


Complaints about bad key characters and tape read/write errors. 
Complaints if enough memory is not available to hold the link tables. 


BUGS 
There is no way to ask for the n-th occurrence of a file. 
Tape errors are handled ungracefully. 
The u option can be slow. 
The b option should not be used with archives that are going to be updated. The current magtape driver can- 
not backspace raw magtape. If the archive is on a disk file the b option should not be used at all, as updat- 
ing an archive stored in this manner can destroy it. 
The current limit on file name length is 100 characters. The u option will only work with archives on disk 
files, because tar now must use the raw tape mechanism. 


Page 2 


TBL(1) 


NAME 


tbl — format tables for nroff or troff 


SYNOPSIS 


tbl [ files ] ... 


DESCRIPTION 


Eighth Edition 


TBL(1) 


Tbl is a preprocessor for formatting tables for nroff or troff(1). The input files are copied to the standard 
output, except for lines between .TS and .TE command lines, which are assumed to describe tables and 
reformatted. Details are given in the reference manual. 


As an example, letting \t represent a tab (which should be typed as a genuine tab) the input 


yields 


.TS 

CSS 

ccs 

ccc 

Inn. 

Household Population 
Town\tHouseholds 
\tNumber\tSize 
Bedminster\t789\t3.26 
Bernards Twp.\t3087\t3.74 
Bernardsville\t2018\t3.30 
Bound Brook\t3425\t3.04 
Branchburg\t1644\t3.49 
Bridgewater\t7897\t3.8 1 
Far Hills\t240\t3.19 


.TE 
Household Population 
Town Households 

Number Size 

Bedminster 789 3.26 

Bernards Twp. 3087 3.74 

Bernardsville 2018 3.30 

Bound Brook 3425 3.04 

Branchburg 1644 3.49 

Bridgewater 7897 3.81 

Far Hills 240 3.19 


If no arguments are given, tb/ reads the standard input, so it may be used as a filter. When it is used with 


eqn or neqn the tbl command should be first, to minimize the volume of data passed through pipes. 


SEE ALSO 


troff(1), eqn(1), doctype(1) 
M. E. Lesk, TBL. 
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NAME 
tee — pipe fitting 


SYNOPSIS 
tee [ -i][-a] [file]... 


DESCRIPTION 
Tee transcribes the standard input to the standard output and makes copies in the files. Option —-i ignores 
interrupts; option —a causes the output to be appended to the files rather than overwriting them. 
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NAME 
telnet — user interface to the telnet protocol 
SYNOPSIS 
telnet [ host [ port ] ] 
DESCRIPTION 
Telnet communicates with another host using the TELNET protocol. If telnet is invoked without argu- 
ments, it prompts ‘telnet>’. In this mode it accepts the commands listed below. If it is invoked with argu- 
ments, it performs an open command (see below) with those arguments. 
Once a connection has been opened, te/net sends typed text to the remote host. To issue telnet commands 
when in input mode, precede them with the telnet escape character, initially control-]. 
The following commands are available. Only a unique prefix of the command need be typed. 
open host [ port | 
Open a connection to the named host. A missing port number defaults to a TELNET server. The 
host may be a host name or an Internet address specified in the ‘dot notation’. 
close Close a TELNET session and return to command mode. 
quit Close any open TELNET session and exit telnet. 
escape [ escape-char | 
Set the telnet escape character. Control characters may be specified as “~’ followed by a single let- 
ter. 
status Show the current status of telnet. 
options Toggle viewing of TELNET options processing. When viewing is on, all TELNET option negoti- 
ations will be displayed. Options sent by telnet are displayed as SENT, options received as 
RCVD. 
crmod Toggle carriage return mode. When this mode is on, carriage return characters received from the 
remote host map into a carriage return and a line feed. 
? [ command | 
Get help. With no arguments, print a help summary. With a command is specified, print informa- 
tion about that command only. 
FILES 
/usr/inet/lib/* 
SEE ALSO 
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NAME 
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test — condition command 


SYNOPSIS 


test expr 


[ expr ] 
DESCRIPTION 


Test evaluates the expression expr, and if its value is true then returns zero exit status; otherwise, a non zero 
exit status is returned. fest returns a non zero exit if there are no arguments. 


The following primitives are used to construct expr. 


-r file 
—w file 
-f file 
-d file 
-s file 


-t [ fildes ] 


-z sl 
—n sl 
sl =s2 
sl !=s2 
sl 


true if the file exists and is readable. 

true if the file exists and is writable. 

true if the file exists and is not a directory. 
true if the file exists exists and is a directory. 


true if the file exists and has a size greater than zero. 


true if the open file whose file descriptor number is fildes (1 by default) is associated with a ter- 
minal device. 


true if the length of string s/ is zero. 

true if the length of the string s/ is nonzero. 
true if the strings s/ and s2 are equal. 

true if the strings s/ and s2 are not equal. 


true if s/ is not the null string. 


nl -eq n2 true if the integers n/ and n2 are algebraically equal. Any of the comparisons —ne, —gt, —ge, It, 


or —-le may be used in place of -eq. 


These primaries may be combined with the following operators: 


! 
—a 


-—0 


unary negation operator 
binary and operator 


binary or operator 


(expr) parentheses for grouping. 


—a has higher precedence than —o. Notice that all the operators and flags are separate arguments to fest. 
Notice also that parentheses are meaningful to the Shell and must be escaped. 


[ is a synonym for fest, except that [ requires a closing ]. 


SEE ALSO 


sh(1), find(1) 
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NAME 
time — time a command 


SYNOPSIS 
time [ —usrtdmfio | [ —v ] command 


DESCRIPTION 
The given command is executed; after it is complete, time reports statistics about the program on its stan- 
dard error output. The statistics printed are controlled by the options; the default is -usr and —v reports 
everything. The statistics are: 


u User cpu time consumed by the command 
s System cpu time attributed to the command 
r Real (clock) time taken by the command 

t Average resident text size, in Kb. 

d Average resident data size, in Kb. 

m Maximum total resident size, in Kb. 

f Number of page faults resulting in disk i/o. 
i Number of disk blocks read. 

oO Number of disk blocks written. 


After the statistics, time prints a tab and the command, up to the fifth argument. Times are reported in sec- 
onds. 


BUGS 
Elapsed time is accurate to the second, while the CPU times are measured to the 60th second. Thus the 
sum of the CPU times can be up to a second larger than the elapsed time. 


Page | 


TK(1) Eighth Edition TK(1) 
NAME 
tk — paginator for the Tektronix 4014 
SYNOPSIS 
tk [-t][-N ][-pZ ] [ file ] 
DESCRIPTION 
The output of tk is intended for a Tektronix 4014 terminal. 7k arranges for 66 lines to fit on the screen, 
divides the screen into N columns, and contributes an eight space page offset in the (default) single-column 
case. Tabs, spaces, and backspaces are collected and plotted when necessary. Teletype Model 37 half- and 
reverse-line sequences are interpreted and plotted. At the end of each page tk waits for a newline (empty 
line) from the keyboard before continuing on to the next page. In this wait state, the command !command 
will send the command to the shell. 
The command line options are: 
-t Don’t wait between pages; for directing output into a file. 
-N Divide the screen into N columns and wait after the last column. 
—pL Set page length to L lines. 
SEE ALSO 
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NAME 
touch — set file modification date 


SYNOPSIS 
touch [ -c ] file ... 


DESCRIPTION 
Touch attempts to set the modified date of each file. This is done by reading a character from the file and 
writing it back. 
If a file does not exist, an attempt will be made to create it unless the -c option is specified. 


SEE ALSO 
utime(2) 


Page | 


TR(1) Eighth Edition TR(1) 
NAME 
tr — translate characters 
SYNOPSIS 
tr [-cds ] [ string] [ string2 ] ] 
DESCRIPTION 
Tr copies the standard input to the standard output with substitution or deletion of selected characters. 
Input characters found in string] are mapped into the corresponding characters of string2. When string2 is 
short it is padded to the length of string] by duplicating its last character. Any combination of the options 
—cds may be used: 
—c complement the set of characters in string] with respect to the universe of characters whose ASCII 
codes are 01 through 0377 
-d delete all input characters in string] 
-s squeeze all strings of repeated output characters that are in string2 to single characters 
In either string the notation a—b means a range of characters from a to b in increasing ASCII order. The 
character ‘\’ followed by 1, 2 or 3 octal digits stands for the character whose ASCII code is given by those 
digits. A ‘V followed by any other character stands for that character. 
The following example creates a list of all the words in ‘filel’ one per line in ‘file2’, where a word is taken 
to be a maximal string of alphabetics. The second string is quoted to protect ‘V from the Shell. 012 is the 
ASCII code for newline. 
tr -—cs A-Za-z “\012° <filel >file2 
SEE ALSO 
ed(1), ascii(7) 
BUGS 
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Won't handle ASCII NUL in string/ or string2; always deletes NUL from input. 
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NAME 
pret, trace — protocol compiler and analyzer 


SYNOPSIS 
pret [ -v ] file 


trace [ -options ] [ arguments ... ] 


DESCRIPTION 
Trace analyzes the consistency of medium-sized data communication protocols. A protocol is specified in 
a nondeterministic guarded command language, ‘Argos,’ that includes case selection, do-loops, variables, 
procedures, and macros. The analyzer can be used to trace deadlocks, unspecified receptions, timing prob- 
lems, errors caused by value passing, and violations of user-specified ‘assertions.’ 


Pret reads the protocol specifications for a set of interacting processes from the file specified, checks its 
syntax and completeness, and prepares a file pret.out for the analyzer containing a finite state machine 
description of the protocol. Under option —v pret lists the numbers of states in the state machines, reports if 
any states are unreachable, and lists the queue sort for each message queue declared. 


Tracing Options: 


In most cases the options ec, f, 1, and v will suffice to perform protocol analyses. The primary tools for 
reducing search times are m, q, and x. Options a, k, and n are for advanced use; i, t, and y are experimen- 
tal. 


Option flags are listed after a single minus sign, followed by a list of zero or more arguments. Options that 
take an argument are matched with an argument from the argument list in the order in which they occur in 
the option list. 


a List all prefix paths that were explored up to the point where they joined a previously analyzed 
path. See also option 1. 


b Blast search. The fastest scan of the state space available. At each step in the analysis select one 
and only one execution option to be explored. Will not analyze non-determinism within process 
descriptions, nor the effect of the arbitrary interleaving of process executions. See also option x. 


cN Invoke a class N validation, where N can be chosen between 0 and 5 inclusive. A class 0 search is 
fast and very partial; a class 5 search is not necessarily fast but fairly complete. 


forF Two different ways to format the output sequences. Option f gives queue histories, in which every 
bracketed message indicates a message sent but not received at the time of the error. F gives a 
time ordered queue history, where each column corresponds to a queue, and each line to a time 


step. 
i Ignore variables. Second order state space folding tool. 
j Find first error sequence and quit. 


kN Set size of state space cache to 1024*N (default N=30). When the caches is filled, one state will 
be deleted for each state added. 


] List execution loops. Warning, there are usually many, and they are hard to interpret. 


mN Restrict search depth to N steps. By default the search depth is restricted to a limit that excludes 
only pathetic executions (e.g. tenfold overlaps). The default limit is always printed on the stan- 
dard error file at the start of a run. 


n Override timeout heuristic. Override the heuristic that avoids generating an abundance of 
‘microsecond’ timeouts. Normally a timeout is only considered if it can resolve a pending lockup. 


qNn Restrict the maximum queue size to N slots, for all queues. 


rN Restrict the runtime to VN minutes. This option cannot be used in combination with R. 
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RN Report on progress every N minutes of real time. By default N=2. 
s Show finite state machine transition tables graphically. Do not perform an analysis. 


tN Ignore the state of process N in state-matching operations. The value of this mechanism remains 
unproven. Try other options first. 


v Verbose. List execution times, size of the state space, number of levels searched, etc. at the end of 
the run. 
x Perform a fast partial search. At each step in the analysis select one process capable of executing 


and explore all options in that one process. Will not explore all possible interleavings. 
y Ignore the state of queues in state-matching operations. 


SEE ALSO 
G. J. Holzmann, Trace — a protocol analyzer, AT&T Bell Laboratories, 1984 
G. J. Holzmann, Automated protocol validation in Argos, AT&T Bell Laboratories, 1984 
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NAME 
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track — selective remote file copy 


SYNOPSIS 


track [ —vntfd ] file machine 
track -r 


DESCRIPTION 


Track uses Datakit to copy files from another machine to the local machine. If the version of the named file 
differs from that existing on the named machine, the remote file is copied. If the named file is a directory, 
the contents of the directory are considered recursively. Files are copied only if they exist on both 
machines. Options: 


-V Normally a report is given for each file copied. Giving the option causes more verbose reports, for 
example about files that exist locally but not remotely. Giving the option twice generates a report 
about each file considered. 

—n Do no copying; just report what would have been copied. 

-t Copy only if a remote file is newer than the local file. 

-f Interpret the following file as a list of files and directories to be handled. 

—d prefix 
Normally track copies from remote files with the same names as the local files. The —-d option takes 
the next argument as a prefix for remote names; in constructing the remote name, the argument 
string that specifies the local file or directory is replaced by the prefix. For example, 

track —d /bin /usr/local/bin ikeya 
asks to copy files from the remote /bin directory to the local /usr/local/bin directory. 
—r This option causes track to act as the remote partner; it is invoked in this way on the other machine, 


and is not intended for use by humans. 


Track has no special privileges. Files must be readable remotely and writable locally by the invoker. It 
attempts to set the time of modification of a copied file to that of the remote original; the attempt can suc- 
ceed only if the invoker of the local file owns it or is the super-user. This feature matters only when ran- 
dom libraries (archives) are being copied, because the loader uses this time to determine whether the sym- 
bol table is up-to-date. 


SEE ALSO 


push(1), cp(1), newer(1) 
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NAME 


troff, nroff — text formatting and typesetting 


SYNOPSIS 


troff [ option ] ... [ file ] ... 
nroff [ option ] ... [ file ] ... 


DESCRIPTION 


FILES 
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Troff formats text in the named files for printing on a phototypesetter; nroff for typewriter-like devices. 
Their capabilities are described in the Nroff/Troff user’s manual. 


If no file argument is present, the standard input is read. An argument consisting of a single minus (—) is 
taken to be a file name corresponding to the standard input. The options, which may appear in any order so 
long as they appear before the files, are: 


-olist Print only pages whose page numbers appear in the comma-separated list of numbers and ranges. 
A range N—M means pages N through M; an initial -V means from the beginning to page N; and a 
final N— means from N to the end. 


—nN Number first generated page N. 


—mname 
Prepend the macro file /usr/lib/tmac/tmac.name to the input files. 


-raN _ Set register a (one character name) to NV. 


-i Read standard input after the input files are exhausted. 

-q Invoke the simultaneous input-output mode of the rd request. 

-Z produce no output: diagnostics and .tm messages only 

Troff only 

-a Send a printable ASCII approximation of the results to the standard output. 


-Tdest Prepare output for typesetter dest. -T202 = Mergenthaler Linotron 202 (default), -Tcat = 
Graphic Systems C/A/T, -Taps = Autologic APS-5. 


-Fdir take font information from directory dir 
Nroff only 


-sN Nroff will halt prior to every N pages (default N=1) to allow paper loading or changing, and will 
resume upon receipt of a newline. 


-Tname Prepare output for specified terminal. Known names include 37 for the (default) Teletype Corpo- 
ration Model 37 terminal, Ip (‘line-printer’) for any terminal without half-line capability, 450 for 
the DASI-450 (Diablo Hyterm), and think (HP ThinkJet, see think(9)). 


-e Produce equally-spaced words in adjusted lines, using full terminal resolution. 


—-h Use output tabs during horizontal spacing to speed output and reduce output character count. Tab 
settings are assumed to be every 8 nominal character widths. 


If the file /usr/adm/tracct is writable, troff writes phototypesetter accounting records there. The integrity of 
that file may be secured by making troff a ‘set user-id’ program. 


/tmp/trtmp* temporary file 
/usr/lib/tmac/tmac.* standard macro files 
/usr/lib/term/* terminal driving tables for nroff 
/usr/lib/font/* font width tables for troff 
/usr/adm/tracct accounting statistics for troff 
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SEE ALSO 
J. F. Ossanna, Nroff/Troff user’s manual 
B. W. Kernighan, A TROFF Tutorial 
d202(1), proof(9.1), apsend(1), eqn(1), tbl(1), refer(1), pic(1), ideal(1), ped(9.1), doctype(1), ms(7) 
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NAME 
true, false — provide truth values 
SYNOPSIS 
true 
false 
DESCRIPTION 
True does nothing, successfully. False does nothing, unsuccessfully. They are typically used in input to 
sh(1) such as: 
while true 
do 
command 
done 
SEE ALSO 
sh(1) 
DIAGNOSTICS 
True has exit status zero, false nonzero. 
BUGS 


For most purposes, true is a slow equivalent for the shell builtin command ‘:’. 
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tset — set terminal modes 


SYNOPSIS 


tset [ options ] [ —m test:type ] ... [ type ] 


DESCRIPTION 


Tset conditionally sets erase and kill characters, tabs, delays, etc. for terminals. It is typically used in 
startup profiles; see sh(1). In default of a specified terminal type (listed in the file ‘/etc/termcap’) the type is 
taken from the environment variable TERM. Option —m determines the type based on source and baud 
rate: 


—m [source |[>baud]:type 


; an 


No sources are distinguished at present. The test ‘>’ may be replaced by ‘<’, ‘=’, or ‘@’ (same as ‘=’). The 
test may be preceded by ‘!’ for negation. A type may be preceded by ‘?’ to cause tset to query whether the 
guess is right. Tests are performed left-to-right until one is satisfied. A final default type prevails when all 
tests fail. Thus 


tset-—m “>1200:5620° “?hp” 


assumes the terminal is a 5620 if the line speed exceeds 1200 baud. Otherwise it assumes an hp terminal 
but asks for confirmation, giving you a chance to name another type. 


The -s option causes tset to place on the standard output shell commands for setting the environment vari- 
ables TERM and TERMCAP. Use this feature thus: 


eval “tset —s options...~ 


On terminals that can backspace but not overstrike and when the erase character is the default erase charac- 
ter (“#’ on standard systems), the erase character is changed to a Control-H (backspace). 


Other options are: 

ec set the erase character to c, or backspace if c is missing 
-kc set the kill character similarly; use “X if c is missing 

-I supress outputting terminal initialization strings 

-Q supress printing “Erase set to’ and ‘Kill set to’ messages 


-S Outputs TERM and TERMCAP in the environment rather than in shell commands 


FILES 
/etc/ttytype terminal id to type map database 
/etc/termcap terminal capability database 
SEE ALSO 
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NAME 
tsort — topological sort 
SYNOPSIS 
tsort [ file ] 
DESCRIPTION 
Tsort produces on the standard output a totally ordered list of items consistent with a partial ordering of 
items mentioned in the input file. If no file is specified, the standard input is understood. 
The input consists of pairs of items (nonempty strings) separated by blanks. Pairs of different items indi- 
cate ordering. Pairs of identical items indicate presence, but not ordering. 
DIAGNOSTICS 
Odd data: there is an odd number of fields in the input file. 
BUGS 


Uses a quadratic algorithm; not worth fixing for the typical use of ordering a library archive file. 
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NAME 
tty — get terminal name 


SYNOPSIS 
tty 


DESCRIPTION 
Tty prints the pathname of the user’s terminal. 


DIAGNOSTICS 
‘not a tty’ if the standard input file is not a terminal. 
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NAME 
ul, hp — print underlines on screen terminals 
SYNOPSIS 
ul [ -i ] [-t terminal | [ file ] ... 
hp [-e][-m ] 
DESCRIPTION 
UI replaces backspaced, overstruck underscores by control sequences suitable for the terminal given by the 
environment variable TERM or by option -t. It reads from the standard input or the named files and writes 
on the standard output. Option -i represents underlining by a separate line of ‘—’ characters. 
Hp is a filter that presents most nroff output sensibly on HP 2600 series terminals. Option —-s stops and 
waits for a newline at the beginning of each page. Option -e uses ‘display enhancement’ features to distin- 
guish underlines, superscripts, and subscripts, which are normally all shown in inverse video. Option —m 
squeezes multiple newlines out of the output. 
SEE ALSO 
column(1) 
BUGS 
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Hp does not reliably handle reverse line feeds as produced by tb/(1); pipe the input through col to get rid of 
them; see column(1). 
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NAME 
unig — report repeated lines in a file 


SYNOPSIS 
unig [ -ude [ +n ] [—-n ] ] [ input [ output ] ] 

DESCRIPTION 
Unig reads the input file comparing adjacent lines. In the normal case, the second and succeeding copies of 
repeated lines are removed; the remainder is written on the output file. Note that repeated lines must be 
adjacent in order to be found; see sort(1). If the —u flag is used, just the lines that are not repeated in the 
original file are output. The —-d option specifies that one copy of just the repeated lines is to be written. The 
normal mode output is the union of the —u and -d mode outputs. 


The -c option supersedes —u and —d and generates an output report in default style but with each line pre- 
ceded by a count of the number of times it occurred. 


The n arguments specify skipping an initial portion of each line in the comparison: 


—n The first n fields together with any blanks before each are ignored. A field is defined as a string 
of non-space, non-tab characters separated by tabs and spaces from its neighbors. 
+n The first n characters are ignored. Fields are skipped before characters. 
SEE ALSO 


sort(1), comm(1) 
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NAME 

usgmake — maintain, update, and regenerate groups of programs 
SYNOPSIS 

usgmake [-f makefile] [-p] [-i] [-k] [-s] [-r] [-m] [-b] [-e] [-m] [-t] [-d] [-q] [ names ] 
DESCRIPTION 
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The following is a brief description of all options and some special names: 


-f makefile Description file name. Makefile is assumed to be the name of a description file. A file name of 
— denotes the standard input. The contents of makefile override the built-in rules if they are 


present. 
-p Print out the complete set of macro definitions and target descriptions. 
-i Ignore error codes returned by invoked commands. This mode is entered if the fake target 


name .IGNORE appears in the description file. 


-k Abandon work on the current entry, but continue on other branches that do not depend on that 
entry. 
-s Silent mode. Do not print command lines before executing. This mode is also entered if the 


fake target name .SILENT appears in the description file. 


—r Do not use the built-in rules. 

—n No execute mode. Print commands, but do not execute them. Even lines beginning with an @ 
are printed. 

—-b Compatibility mode for old makefiles. 

-e Environment variables override assignments within makefiles. 

—m Print a memory map showing text, data, and stack. This option is a no-operation on systems 


without the getu system call. 


-t Touch the target files (causing them to be up-to-date) rather than issue the usual commands. 
-d Debug mode. Print out detailed information on files and times examined. 
-q Question. The make command returns a zero or non-zero status code depending on whether 


the target file is or is not up-to-date. 


-DEFAULT If a file must be made but there are no explicit commands or relevant built-in rules, the com- 
mands associated with the name .DEFAULT are used if it exists. 


-PRECIOUS 
Dependents of this target will not be removed when quit or interrupt are hit. 


SILENT Same effect as the -s option. 
-IGNORE Same effect as the -i option. 


Make executes commands in makefile to update one or more target names. Name is typically a program. If 
no -f option is present, makefile, Makefile, s.makefile, and s.Makefile are tried in order. If makefile is -, 
the standard input is taken. More than one - makefile argument pair may appear. 


Make updates a target only if it depends on files that are newer than the target. All prerequisite files of a 
target are added recursively to the list of targets. Missing files are deemed to be out of date. 


Makefile contains a sequence of entries that specify dependencies. The first line of an entry is a blank- 
separated, non-null list of targets, then a :, then a (possibly null) list of prerequisite files or dependencies. 
Text following a ; and all following lines that begin with a tab are shell commands to be executed to update 
the target. The first line that does not begin with a tab or # begins a new dependency or macro definition. 
Shell commands may be continued across lines with the <backslash><new-line> sequence. Everything 
printed by make (except the initial tab) is passed directly to the shell as is. Thus, 
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echo a\ 
b 


will produce 
ab 
exactly the same as the shell would. 
Sharp (#) and new-line surround comments. 


The following makefile says that pgm depends on two files a.o and b.o, and that they in turn depend on 
their corresponding source files (a.c and b.c) and a common file incl.h: 


pgm: a.o b.o 

cc a.o b.o -0 pgm 
a.o: incl.h a.c 

cc -C ac 
b.o: incl.h b.c 

cc -c b.c 


Command lines are executed one at a time, each by its own shell. The first one or two characters in a com- 
mand can be the following: -, @, -@, or @-. If @ is present, printing of the command is suppressed. If - is 
present, make ignores an error. A line is printed when it is executed unless the -s option is present, or the 
entry .SILENT: is in makefile, or unless the initial character sequence contains a @. The -n option 
specifies printing without execution; however, if the command line has the string $(MAKE) in it, the line is 
always executed (see discussion of the MAKEFLAGS macro under Environment). The -t (touch) option 
updates the modified date of a file without executing any commands. 


Commands returning non-zero status normally terminate make. If the -i option is present, or the entry 
-IGNORE: appears in makefile, or the initial character sequence of the command contains -. the error is 
ignored. If the -k option is present, work is abandoned on the current entry, but continues on other 
branches that do not depend on that entry. 


The —b option allows old makefiles (those written for the old version of make) to run without errors. The 
difference between the old version of make and this version is that this version requires all dependency 
lines to have a (possibly null or implicit) command associated with them. The previous version of make 
assumed if no command was specified explicitly that the command was null. 


Interrupt and quit cause the target to be deleted unless the target is a dependency of the special name .PRE- 
CIOUS. 


Environment 
The environment is read by make. All variables are assumed to be macro definitions and processed as such. 
The environment variables are processed before any makefile and after the internal rules; thus, macro 
assignments in a makefile override environment variables. The -e option causes the environment to over- 
ride the macro assignments in a makefile. 


The MAKEFLAGS environment variable is processed by make as containing any legal input option (except 
-f, —p, and -d) defined for the command line. Further, upon invocation, make ‘‘invents’’ the variable if it 
is not in the environment, puts the current options into it, and passes it on to invocations of commands. 
Thus, MAKEFLAGS always contains the current input options. This proves very useful for ‘‘super- 
makes’’. In fact, as noted above, when the —n option is used, the command $(MAKE) is executed anyway; 
hence, one can perform a make —n recursively on a whole software system to see what would have been 
executed. This is because the —n is put in MAKEFLAGS and passed to further invocations of $(MAKE). 
This is one way of debugging all of the makefiles for a software project without actually doing anything. 


Macros 
Entries of the form string] = string2 are macro definitions. String2 is defined as all characters up to a com- 
ment character or an unescaped newline. Subsequent appearances of $(string/ [:subst]=[subst2]]) are 
replaced by string2. The parentheses are optional if a single character macro name is used and there is no 
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substitute sequence. The optional :subst]=subst2 is a substitute sequence. If it is specified, all non- 
overlapping occurrences of subst] in the named macro are replaced by subst2. Strings (for the purposes of 
this type of substitution) are delimited by blanks, tabs, new-line characters, and beginnings of lines. An 
example of the use of the substitute sequence is shown under Libraries. 


Internal Macros 


There are five internally maintained macros which are useful for writing rules for building targets. 


$* | The macro $* stands for the file name part of the current dependent with the suffix deleted. It is eval- 
uated only for inference rules. 


$@ The $@ macro stands for the full target name of the current target. It is evaluated only for explicitly 
named dependencies. 


$< The $< macro is only evaluated for inference rules or the .DEFAULT rule. It is the module which is 
out of date with respect to the target (i.e., the “‘manufactured’’ dependent file name). Thus, in the 
.c.o rule, the $< macro would evaluate to the .c file. An example for making optimized .o files from 
.c files is: 


.C.0: 
cc -c —O $*.c 


or: 


cc -c -O $< 


$? The $? macro is evaluated when explicit rules from the makefile are evaluated. It is the list of prereq- 
uisites that are out of date with respect to the target; essentially, those modules which must be rebuilt. 


$% The $% macro is only evaluated when the target is an archive library member of the form lib(file.o). 
In this case, $@ evaluates to lib and $% evaluates to the library member, file.o. 


Four of the five macros can have alternative forms. When an upper case D or F is appended to any of the 
four macros the meaning is changed to ‘‘directory part’ for D and ‘‘file part’’ for F. Thus, $(@D) refers to 
the directory part of the string $@. If there is no directory part, The only macro excluded from this alterna- 
tive form is $?. The reasons for this are debatable. 


Suffixes 
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Certain names (for instance, those ending with .o) have inferable prerequisites such as .c, .s, etc. If no 
update commands for such a file appear in makefile, and if an inferable prerequisite exists, that prerequisite 
is compiled to make the target. In this case, make has inference rules which allow building files from other 
files by examining the suffixes and determining an appropriate inference rule to use. The current default 
inference rules are: 


.c .c’ .sh .sh” .c.0 .c™.0 .c™.c .S.0 .S.0 -y.0 .y~.0 Lo 17.0 
“.c .yY.c .Lc .c.a .c’.a .s.a -hh 


The internal rules for make are contained in the source file rules.c for the make program. These rules can 
be locally modified. To print out the rules compiled into the make on any machine in a form suitable for 
recompilation, the following command is used: 


make —fp — 2>/dev/null </dev/null 
The only peculiarity in this output is the (null) string which printf(3S) prints when handed a null string. 


A tilde in the above rules refers to an SCCS file (see sccsfile(5)). Thus, the rule .c~.o would transform an 
SCCS C source file into an object file (.o). Because the s. of the SCCS files is a prefix it is incompatible with 
make’s suffix point-of-view. Hence, the tilde is a way of changing any file reference into an SCCS file ref- 
erence. 


A tule with only one suffix (i.e. .c:) is the definition of how to build x from x.c. In effect, the other suffix is 
null. This is useful for building targets from only one source file (e.g., shell procedures, simple C pro- 
grams). 
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Additional suffixes are given as the dependency list for SUFFIXES. Order is significant; the first possible 
name for which both a file and a rule exist is inferred as a prerequisite. The default list is: 


-SUFFIXES: .0 .c -y 1 .s 


Here again, the above command for printing the internal rules will display the list of suffixes implemented 
on the current machine. Multiple suffix lists accumulate; .SSUFFIXES: with no dependencies clears the list 
of suffixes. 


Inference Rules 
The first example can be done more briefly: 


pgm: a.o b.o 
cc a.o b.o -0 pgm 
a.o b.o: incl.h 


This is because make has a set of internal rules for building files. The user may add rules to this list by sim- 
ply putting them in the makefile. 


Certain macros are used by the default inference rules to permit the inclusion of optional matter in any 
resulting commands. For example, CFLAGS, LFLAGS, and YFLAGS are used for compiler options to 
cc(1), lex(1), and yacc(1) respectively. Again, the previous method for examining the current rules is rec- 
ommended. 


The inference of prerequisites can be controlled. The rule to create a file with suffix .o from a file with 
suffix .c is specified as an entry with .c.o: as the target and no dependents. Shell commands associated with 
the target define the rule for making a .o file from a .c file. Any target that has no slashes in it and starts 
with a dot is identified as a rule and not a true target. 


Libraries 

If a target or dependency name contains parenthesis, it is assumed to be an archive library, the string within 
parenthesis referring to a member within the library. Thus lib(file.o) and $(LIB)(file.o) both refer to an 
archive library which contains file.o. (This assumes the LIB macro has been previously defined.) The 
expression $(LIB)(filel.o file2.o) is not legal. Rules pertaining to archive libraries have the form .XX.a 
where the XX is the suffix from which the archive member is to be made. An unfortunate byproduct of the 
current implementation requires the XX to be different from the suffix of the archive member. Thus, one 
cannot have lib(file.o) depend upon file.o explicitly. The most common use of the archive interface fol- 
lows. Here, we assume the source files are all C type source: 


lib: lib(filel.o) lib(file2.0) lib(file3.o) 
@echo lib is now up to date 


$(CC) -c $(CFLAGS) $< 
ar rv $@ $*.0 
rm -f $*.0 


In fact, the .c.a rule listed above is built into make and is unnecessary in this example. A more interesting, 
but more limited example of an archive library maintenance construction follows: 


lib: lib(filel.o) lib(file2.0) lib(file3.o) 
$(CC) -c $(CFLAGS) $(?:.0=.c) 
ar rv lib $? 
rm $? @echo lib is now up to date 
CC. 


Here the substitution mode of the macro expansions is used. The $? list is defined to be the set of object 
file names (inside lib) whose C source files are out of date. The substitution mode translates the .o to .c. 
(Unfortunately, one cannot as yet transform to .c~; however, this may become possible in the future.) Note 
also, the disabling of the .c.a: rule, which would have created each object file, one by one. This particular 
construct speeds up archive library maintenance considerably. This type of construct becomes very cum- 
bersome if the archive library contains a mix of assembly programs and C programs. 
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FILES 
[MmlJakefile and s.[MmlJakefile 
SEE ALSO 
sh(1), mk(8). 
Make-A Program for Maintaining Computer Programs by S. 1. Feldman. 
An Augmented Version of Make by E. G. Bradford. 
BUGS 


Some commands return non-zero status inappropriately; use -i to overcome the difficulty. Commands that 
are directly executed by the shell, notably cd(1), are ineffectual across new-lines in make. The syntax 
(lib(file1.o file2.0 file3.0) is illegal. You cannot build lib(file.o) from file.o. The macro $(a:.0=.c7) doesn’t 
work. 
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NAME 
uucp, uulog, uuname — unix to unix remote file copy 
SYNOPSIS 
uucp [ options ] source ... destination 
uulog [ options ] [ system ] 
or 
uuname [ -1 | 
DESCRIPTION 
Uucp. 
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Uucp copies source files to the destination file or directory. A file name may be a path name on your 
machine, or may have the form: 


system-name!path-name 


where system-name is taken from a list of system names that uucp knows about. System-name may also be 
a chain of names such as 


in which case an attempt is made to send via the specified route. Care should be taken to ensure that inter- 
mediate nodes in the route are willing to foward information. 


Quoted shell metacharacters ?, * and [ ] appearing in a remote path-name will be expanded on the appropri- 
ate system. 


Path names may be: 
(1) a full path name; 


(2) a path name preceded by “user where user is a login name on the specified system and is 
replaced by that user’s login directory; 


(3) a path name preceded by “/destination where destination is appended to 
‘/usr/spool/uucppublic/’; The destination will be treated as a file name unless more than 
one file is being transfered by this request or the destination is already a directory or the 
destination ends with ‘/’. For example, ~/dan/ as the destination will make the directory 
/usr/spool/uucppublic/dan if it does not exist and put the requested file(s) in that direc- 
tory. 


(4) anything else is prefixed by the current directory. 


If the result is an erroneous path name for the remote system the copy will fail. If the destination is a direc- 
tory, the last part of the source-file name is used. 


Uucp preserves execute permissions across the transmission and gives 0666 read and write permissions 
(see chmod(2)). 


The following options are interpreted by uucp: 

-c Don’t copy local file to the spool directory for transfer to the remote machine (default). 
-C Force the copy of local files to the spool directory for transfer. 

-d Make all necessary directories for the file copy (default). 


-f Do not make intermediate directories for the file copy. 


Grade is a single letter/number; lower ASCII sequence characters will cause the job to be transmit- 
ted earlier during a particular conversation. 


-j Output the job identification ASCII string on the standard output. This job identification can be 
used by uustat to obtain the status or terminate a job. 
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—m Send mail to the requester when the copy is completed. 
-sfile Report status of the transfer to file. 

-nuser Notify user on the remote system that a file was sent. 
-r Don’t start the file transfer, just queue the job. 


—xdebug-level 
Produce debugging output. The debug level is a number between 0 and 9; higher numbers give 
more detailed information. 


Uulog. 


Uulog queries a log file of uucp or uuxqt transactions, optionally limited to a given system. Its options are 
-f Print recent transactions and follow further transactions as they occur. 
-x Look in the uuxat log file for the given system. 


—number 
Print the last number transactions. 


Uuname. 


FILES 


Uuname lists the uucp names of known systems. The -I option returns the local system name. 


/usr/spool/uucp spool directories 
/ustr/spool/uucppublic public directory for receiving and sending 
/usr/lib/uucp/* other data and program files 


/ustr/spool/uucp/.Log/uuxqt/system log of uuxqt transactions with system 
/usr/spool/uucp/.Log/uucico/system 
log of uucp transactions with system 


SEE ALSO 


mail(1), uux(1) 


WARNING 


BUGS 


For obvious security reasons, the domain of remotely accessible files may be severely restricted. You will 
very likely not be able to fetch files by path name; ask a responsible person on the remote system to send 
them to you. For the same reasons you will probably not be able to send files to arbitrary path names. As 
distributed, the remotely accessible files are those whose names begin ‘/usr/spool/uucppublic/’ (equivalent 
to 7’). 

All files received by uucp will be owned by uucp. 

The -—m option will only work sending files or receiving a single file. Receiving multiple files specified by 
special shell characters ? * [...] will not activate the —m option. 


The forwarding of files through other systems is NOT compatible with the previous version of uucp. If for- 
warding is used, all systems in the route must have the same version of uucp. 


Protected files and files that are in protected directories that are owned by the requester can be sent by uucp. 
However, if the requester is root, and the directory is not searchable by group ‘other’ or the file is not read- 
able by ‘other’, the request will fail due to a bug in setuid(2). 


Page 2 


UUSTAT(1) 


NAME 


Eighth Edition UUSTAT(1) 


uustat — uucp status inquiry and job control 


SYNOPSIS 
uustat [ option ] 


uustat [ -ssystem ] [ —uuser ] 


DESCRIPTION 
Uustat will display the status of, or cancel, previously specified uucp commands, or provide general status 
on uucp connections to other systems. The following options are recognized: 


—a 
—-kjobid 


—m 


-?p 
-q 


-rjobid 


—Ssys 
—uuser 


output all jobs in queue. 

Kill the uwucp request whose job identification is jobid. The killed uucp request must belong to 
the person issuing the wustat command unless one is the super-user. 

Report the status of accessibility of all machines. 

Report on the status of all processes that are in the lock files. 

List the jobs queued for each machine. If a status file exists for the machine, its date, time and 
status information are reported. A parenthesized number next to the number of C or X files 
gives the age in days of the oldest file for that system. The Retry field represents the number of 
hours until the next possible call. The Count is the number of failure attempts. NOTE: for sys- 
tems with a moderate number of outstanding jobs, this could take 30 seconds or more of real- 
time to execute. 

Rejuvenate jobid. The files associated with jobid are touched so that their modification time is 
set to the current time. This prevents the cleanup demon from deleting the job until the jobs 
modification time reaches the limit imposed by the demon. 

Report the status of all wucp requests for remote system sys. 

Report the status of all wucp requests issued by user. 


When no options are given, uustat outputs the status of all uucp requests issued by the current user. 


FILES 

/usr/spool/uucp/* spool directories 
SEE ALSO 

uucp(1) 
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uux — unix to unix command execution 


SYNOPSIS 


uux [ options ] command-string 


DESCRIPTION 
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Uux will gather zero or more files from various systems, execute a command on a specified system and then 
send standard output to a file on a specified system. Note that, for security reasons, many installations will 
limit the list of commands executable on behalf of an incoming request from uux. Many sites will permit 
little more than the receipt of mail (see mail(1)) via uux. 


The command-string is made up of one or more arguments that look like a Shell command line, except that 
the command and file names may be prefixed by system-name!. A null system-name is interpreted as the 
local system. 


File names may be one of 
(1) a full path name; 


(2) a path name preceded by “xxx where xxx is a login name on the specified system and is 
replaced by that user’s login directory; 


(3) anything else is prefixed by the current directory. 
As an example, the command 
uux "!diff usg!/usr/dan/filel pwba!/a4/dan/file2 > !/dan/file.diff" 


will get file] and file2 from the ‘usg’ and ‘pwba’ machines, execute a diff command and put the results in 
file.diff in the local ~/dan/ directory. 


Any special shell characters such as <>;| should be quoted either by quoting the entire command-string, or 
quoting the special characters as individual arguments. 


Uux will attempt to get all files to the execution system. For files that are output files, the file name must be 
escaped using parentheses. For example, the command 


uux a!cut —-f1 b!/usr/file \(c!/usr/file\) 


gets /usr/file from system ‘b’ and send it to system ‘a’, performs a cut command on that file and send the 
result of the cut command to system ‘c’. 


Uux will notify you by mail if the requested command on the remote system was disallowed. This 
notification can be turned off by the —n option. 


The following options are interpreted by uux: 
- The standard input to uux is made the standard input to the command-string. 


-aname Use name as the user identification replacing the initiator user-id. (Notification will be returned to 


the user.) 
-b Return standard input to the command if the exit status is non-zero. 
-c Don’t copy local file to the spool directory for transfer to the remote machine (default). 
-C Force the copy of local files to the spool directory for transfer. 


—ggrade 
Grade is a single letter/number; lower ASCII sequence characters will cause the job to be transmit- 
ted earlier during a particular conversation. 


-j Output the jobid ASCII string on the standard output which is the job identification. This job 
identification can be used by uustat to obtain the status or terminate a job. 


—n Do not notify the user if the comand fails. 
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-p Same as —: The standard input to uux is made the standard input to the command-string. 
-r Don’t start the file transfer, just queue the job. 
-sfile Report status of the transfer in file. 


—xdebug-level 
Produce debugging output on stdout. The debug level is a number between 0 and 9; higher num- 
bers give more detailed information. 


-Z Notify the user if the command succeeds. 
FILES 

/usr/lib/aucp/spool spool directories 

/usr/lib/uucp/* other data and programs 
SEE ALSO 

uucp(1) 
WARNINGS 


Only the first command of a shell pipeline may have a system-name!. All other commands are executed on 
the system of the first command. 

The use of the shell metacharacter * will probably not do what you want it to do. The shell tokens << and 
>> are not implemented. 


The execution of commands on remote systems takes place in an execution directory known to the uucp 
system. All files required for the execution will be put into this directory unless they already reside on that 
machine. Therefore, the simple file name (without path or machine reference) must be unique within the 
uux request. The following command will NOT work: 


uux "a!ldiff b!/usr/dan/xyz c!/usr/dan/xyz > !xyz.diff" 
but the command 

uux "aldiff a!/usr/dan/xyz c!/usr/dan/xyz > !xyz.diff" 
will work. (If diffis a permitted command.) 


BUGS 
Protected files and files that are in protected directories that are owned by the requester can be sent in com- 
mands using uux. However, if the requester is root, and the directory is not searchable by "other" or the file 
is not readable by "other", the request will fail due to a bug in setuid(). 
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NAME 
ex, vi — text editor 
SYNOPSIS 
ex [-] [-v ] [-t tag ] [-r] [-R] [+command ] [-1] name ... 
edit [ options | 
vi [ -t tag ] [-r ] [-R ] [ +command ] [ -1] [-wn ] name ... 
DESCRIPTION 
Ex is a superset of ed(1) with a display editing facility; edit is a simplified subset of ex; and vi is a fully 
display-based editor with similar capabilities. Option -R makes the editor read-only. 
FILES 
/usr/lib/ex?.?strings error messages 
/usr/lib/ex?.?recover recover command 
/usr/lib/ex?.? preserve preserve command 
/etc/termcap describes capabilities of terminals 
“/.exrce editor startup file 
/tmp/Exnannn editor temporary 
/tmp/Rxnnnnn named buffer temporary 
/usr/preserve preservation directory 
SEE ALSO 
Edit: A Tutorial 
Ex Reference Manual 
An Introduction to Display Editing with Vi 
Vi Quick Reference Card, all in BSD 4.1 Progammer’s Manual, Volume 2 
ed(1), jim(9.1), sed(1) 
BUGS 
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The undo command causes all marks to be lost on lines changed and then restored if the marked lines were 
changed. 

Undo never clears the buffer modified condition. 

The z command prints a number of logical rather than physical lines. More than a screen full of output may 
result if long lines are present. 

File input/output errors don’t print a name if the command line ‘—’ option is used. 

There is no easy way to do a single scan ignoring case. 

The editor does not warn if text is placed in named buffers and not used before exiting the editor. 

Null characters are discarded in input files, and cannot appear in resultant files. 

Software tabs using “T work only immediately after the autoindent. 

The wrapmargin option can be fooled since it looks at output columns when blanks are typed. If a long 
word passes through the margin and onto the next line without a break, then the line won’t be broken. 

The source command does not work when executed as :source; there is no way to use the :append, 
:change, and :insert commands in vi, since it is not possible to give more than one line of input to a: 
escape. To use these on a :global you must Q to ex command mode, execute them, and then reenter the 
screen editor with vi or open. 
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NAME 


view2d — movie of a function f(x, y, t) 


SYNOPSIS 


view2d [ option ... | file 
regrid [ option ... ] file 
vdata [ option ... ] file 


DESCRIPTION 


View2d displays a sequence of functional surfaces on a 5620 or color display. On the 5620, the surface is 
ruled with a square mesh and projected isometrically; on a color display, the surface is viewed from above, 
with height indicated by color. The options are: 


-T5 output on the 5620; -TS5 is the default when TERM (see environ(7)) is 5620. 
-Tc output on color display; -Tc is the default when TERM is not 5620. 

-Tp produces input for plot(1) to produce contour plots. 

—cn use 1 colors (n=32 by default) or contours (6 by default). 

—ps run movie for s seconds (s=5 by default). 


There are two supported ways to generate input for view2d. Vdata takes ASCII input and allows scattered 
data; view2d(3) can be called from a program that already has data on a grid. 


Regrid changes the grid sizes in view2d binary files, with options: 


-b adds a bar at the bottom of the image indicating time. 

—nNX[,NY] output grid is NX by NY. 

-{NF output will have NF frames. 

—r the plane of closest fit to the first frame is subtracted from all the frames. 


—mfmin,fmax clips the data to the range fmin,fmax. 
One option applies to both view2d and regrid: 
-tTS[,7TE] displays frames from 7S (default first frame time) to TE (default last frame time). 


Vdata takes input in the following format and converts to input for view2d. The first line of each frame has 
the number of data points in the frame (an integer) and the time (a floating point value). The rest of the 
lines in the frame consist of x y z triples. The order of points is irrelevant. Every (floating point or integer) 
number must be white space separated. The options are: 


—nNX[,NY] output grid is NX by NY. 


Cc use piecewise constant rather than linear interpolation. 

-S scatterplot the data on a black background. 

-i the data is already on a square grid, in the order x and y ascending with x varying fastest. 
SEE ALSO 
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view2d(3), view2d(5) 
Exotic options for photography, color maps, and halftone are described in /usr/ib/view2d/howto . 
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NAME 
vis — show invisible characters 
SYNOPSIS 
vis [-t ] [-s ] file ... 
DESCRIPTION 
Vis reads each file in sequence and writes it on the standard output. Non-printing characters are translated 
on output as in the ‘I’ (list) command of ed(1). If no file is given vis reads from the standard input. Option 
—t suppresses translation of tabs. Option -s strips non-printing characters and makes no other translation. 
SEE ALSO 


cat(1), ed(1) 
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NAME 
visi — mathematical spreadsheet 


SYNOPSIS 
visi [ file ] 


DESCRIPTION 
Visi is a tabular mathematical worksheet for data analysis. If a file is specified, commands are read from 
that file when visi first starts. 


Visi works only on cursor-controlled terminals such as the HP2621, and requires the environment variable 
TERM (see environ(7)) to be set appropriately. 


Visi prompts for input at the top of the screen with ‘>>’. Input has one of the forms, 
command parameters 
variable = expression 
variable = "string" 


where a variable is a letter and number sequence, for example: ‘A2, B10, BB23.’ These variables represent 
locations on the worksheet; A2 is column A, row 2. If you type, in any order, 


Al =A2+4+5 
A2= 10 
the values 15 and 10 will appear on the screen. If you later type 
A2 = 20 
the values will be updated to 25 and 20. Visi treats upper and lower case letters as identical. 


Expressions are parsed, and standard mathematical precedence is retained. The operators +, -, *, /, ** (or *) 
can be used in expressions. 


Commands 


copy [file | 
Copy the screen image to the file. If a file is not specified, visi will prompt for one. 


debug Toggle a flag to give yacc(1) debugging output, very unreadable. 


duplicate p/ thru p2 at p3 
Duplicate a block of definitions in another portion of the screen. P/ and p2 are the upper left 
corner and the lower right corner of the block to be duplicated. P3 is the upper left corner of 
the destination. 


edit Edit the commands list. If the environment variable ‘ED’ is set, it is used as the name of the 
editor. Otherwise, ed(1). is called. 


help Display a brief synopsis of the commands. 
list List the current definitions on the terminal. 
quit Quit the program. 

read [ file | 


Read input lines from the file. If a file is not specified, visi will prompt for one. 
redraw Redraw the screen in the event the terminal output was corrupted. 


replicate p/ at p2 thru p3 
Replicate the single definition at p/ throughout the block from p2 in the upper left corner thru 
p3 in the lower right. 


scale [ column | nnn 
Change the scale of the specified column, or of the entire tableau if a column is not specified. 
The scale nnn is the number of decimal places that are displayed to the right of the decimal 


Page | 


VISI(1) Eighth Edition VISI(1) 


point. Calculations are done in double precision regardless of scale. 


shift direction [ nnn | 
Shift the current screen in any direction. The screen is only a window on the tableau. To see 
other portions of the tableau, the screen must be shifted. Valid directions are: up, down, left, 
right. Nnn is the number of positions to shift the screen (default 1). 


shell Invoke /bin/sh as an inferior process to visi. 
ver Print the current version number of visi. 


width column nnn 
Change the width of a column on the display, or of the entire tableau if no column is specified. 


write [ file ] 
Write commands to a file. Ifa file is not specified, visi will prompt for one. 


Built-in Functions 


abs(e) Absolute value of e. 
acos(e) Arc cosine of e. 
asin(e) Arc sine of e. 
atan(e) Arc tangent of e. 
atan2(e/,e2) 

Arc tangent of el/e2. 
cos(e) Cosine of e. 
exp(e) Exponential function of e. 
gamma(e) Log of the gamma function of e. 
hypot(e/,e2) 

Square root of the sum of the squares of e/ and e2. 
int(e) The integer part of e (truncated toward zero.) 
log(e) Natural log of e. 
pi The constant 3.14159265358979.... 
pow(el,e2) Same as el’e2. 
sin(e) Sine of e. 
sqrt(e) Square root of e. 


Other Special Definitions 
position[e/ ,e2] 
The quantity at row e/, column e2 of the tableau. Numbering for the columns is A = 1, B = 2, 
..., AA = 27, and so on. 


ROW The row number of this entry. 
COL The column number of this entry. 
SEE ALSO 
ed(1), exp(3), sin(3) 
FILES 
/usr/lib/visi.help 
BUGS 


A circular list of variable declarations can cause visi to hang in a loop. 
Scale does truncation, not rounding. 
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NAME 
we — word count 


SYNOPSIS 
we [-Iwe | [ name... ] 


DESCRIPTION 
Wc counts lines, words and characters in the named files, or in the standard input if no name appears. A 
word is a maximal string of characters delimited by spaces, tabs or newlines. 


If the optional argument is present, just the specified counts (lines, words or characters) are selected by the 
letters I, w, orc. 
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NAME 
who, whois — who is on the system 


SYNOPSIS 
who [-i] [ who-file ] 


who ami 
whois username 


DESCRIPTION 
Who, without an argument, lists the login name, terminal name, and login time for each current UNIX user. 
With the -i option, the report includes the number of minutes that the user’s terminal has been idle. 


With two arguments, as in ‘who am I (and also ‘who are you’), who tells who you are logged in as. 


Without an argument, who examines the /etc/utmp file to obtain its information. Ifa file is given, that file is 
examined. Typically the given file will be /usr/adm/wtmp, which contains a record of all the logins since it 
was created. Then who lists logins, logouts, and crashes since the creation of the wtmp file. Each login is 
listed with user name, terminal name (with ‘/dev/’ suppressed), and date and time. When an argument is 
given, logouts produce a similar line without a user name. Reboots produce a line with ‘x’ in the place of 
the device name, and a fossil time indicative of when the system went down. 


Whois consults administrative files to identify the username. (Actually, whois uses grep(1) and can locate 
information by any useful key, such as real name or telephone number.) 


FILES 
/etc/utmp 
/usr/adm/usrlist 
/etc/passwd 
SEE ALSO 


last(1), getuid(1), getuid(2), utmp(5), wtmp(5) 
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NAME 


write — write to other users 


SYNOPSIS 


write person ... 


DESCRIPTION 


FILES 


Write copies lines from your terminal to terminals of other persons designated either by login name or (to 
circumvent occasional ambiguities) by terminal name as given by who(1). It announces to each person 
your login name, your terminal, and the other persons. To respond, each recipient should execute a corre- 
sponding write to the persons he wants to talk to. 


When you are writing to more than one person, your messages are identified to the recipients. Writing ends 
upon end of file or interrupt, and the message ‘EOF’ is sent to the others. 


Write recognizes certain commands during a conversation: 
!cmd Execute a shell on the string cmd and then return to write. 


:aperson Add person to the list of people to whom you are talking, and send an appropriate announce- 
ment to all parties. They must do :a for themselves if they want to include the new person. 


:d person Drop person from your list and make appropriate announcements. 
il Print a list of people to whom you are talking. 


The following protocol is suggested for using write: when you first write to another user, wait for him to 
write back before starting to send. Each party should end each message with a distinctive signal—(o) for 
‘over’ is conventional—that the other may reply. (00) for ‘over and out’ is suggested when conversation is 
about to be terminated. 


Permission to write may be denied or granted by mesg(1). Normally writing is allowed. Certain com- 
mands, in particular nroff and pr(1) disallow messages in order to prevent messy output. 


/etc/utmp to find user 
/bin/sh to execute ‘!’ 


SEE ALSO 


BUGS 
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mesg(1), who(1), mail(1) 


Messages ought to be identified when the recipient is receiving from more than one writer, rather than when 
the writer is sending to more than one recipient, but that requires cooperating processes and isn’t worth the 
effort. 
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NAME 


wwb, style, diction, punct — writers workbench 


SYNOPSIS 


wwb style [ option ] ... file... 
wwh diction [ option ] ... file ... 
wwb suggest 

wwb punct file ... 


wwb wwb [ -ms | [ -mm ] file ... 


DESCRIPTION 


Wwb controls many subprograms documented in the references. For the full treatment use ‘wwb wwb’, but 
for quick use the following subprograms are recommended. 


Style reports on readability, sentence length and structure, word length and usage, verb type, and sentence 
openers in the named documents. 


Diction prints all sentences that contain phrases from a list of bad or verbose word patterns. Option —p pfile 
supplies an additional private pattern file; option —n skips the standard one. 


Suggest reads, from the standard input, phrases deprecated by diction and proposes alternatives. 


Punct reports sentences that appear to violate standard punctuation rules and sentences that contain doubled 
words. 


Style and diction expect documents prepared for nroff/troff(1) and the preprocessors pic, ideal, grap, eqn, 
refer, and tbi(1). Option —mm overrides the default macro package, -ms. The related option —ml skips 
mm-style lists, and should be used if there are many lists of non-sentences. 


Other options for style are: 

-a print all sentences with their length and readability index. 

-e print all sentences that begin with an expletive. 

-p print all sentences that contain a passive verb. 

—Inum print all sentences longer than num. 

-rnum print all sentences whose readability index is greater than num. 


—-P print parts of speech of the words in the document. 


SEE ALSO 


BUGS 
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deroff(1), spell(1) 
Writer’s Workbench User’s Manual, /ust/man/manw/* 


Use of non-standard formatting macros may cause incorrect sentence breaks. 
Imperatives cannot be recognized. 
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NAME 
wwvy — print and set the date from accurate clock 
SYNOPSIS 
wwv [-b-s-f-u ] 
DESCRIPTION 
Wwyv connects to a clock synchronized with radio station WWV. With no argument it prints the time 
obtained. It accepts these arguments: 
-b Print both the WWV time and the system’s current idea of the time. 
-s Set the system’s time to agree with WWV. You must be super-user. The system time cannot be 
changed by more than 20 minutes. 
-f With —s, force the time to be set by WWV even if the local time disagrees by more than 20 min- 
utes. 
-u Report time in UTC rather than local time. 
FILES 
/usr/adm/wtmp to record time-setting 
SEE ALSO 
date (1), utmp(5) 
BUGS 


The WWYV clock has been observed to slip sync by an integral number of minutes or hours from the radio 
standard. 
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NAME 
xsend, xget, enroll — secret mail 


SYNOPSIS 
xsend person 
xget 
enroll 
DESCRIPTION 
These commands implement a secure communication channel; it is like mail(1), but no one can read the 
messages except the intended recipient. The method embodies a public-key cryptosystem using knapsacks. 


To receive messages, use enroll; it asks you for a password that you must subsequently quote in order to 
receive secret mail. 


To receive secret mail, use xget. It asks for your password, then gives you the messages. 


To send secret mail, use xsend in the same manner as the ordinary mail command. (However, it will accept 
only one target). A message announcing the receipt of secret mail is also sent by ordinary mail. 


FILES 
/usr/spool/secretmail/*.key: keys 
/usr/spool/secretmail/*.[0-9]: messages 


SEE ALSO 
mail (1) 


BUGS 
It should be integrated with ordinary mail. 
There is no provision for intermachine mail. 
The announcement of secret mail makes traffic analysis possible. 
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NAME 


yacc, eyacc — yet another compiler-compiler 


SYNOPSIS 


yacc [ -vdD ] [ -o output | [ -s stem ] grammar 


eyacc [ —v ] [ grammar ] 


DESCRIPTION 


Yacc converts a context-free grammar into a set of tables for a simple automaton which executes an LR(1) 
parsing algorithm. The grammar may be ambiguous; specified precedence rules are used to break ambigui- 
ties. 


The output file, y.tab.c, must be compiled by the C compiler to produce a program yyparse. The output file 
name can be set with the -o flag. This program must be loaded with the lexical analyzer program, yylex, as 
well as main and yyerror, an error handling routine. These routines must be supplied by the user; Jex(1) is 
useful for creating lexical analyzers usable by yacc. 


If the -D flag is given, yacc creates y.debug, which contains default error messages for the parser. The 
parser will use them if it is compiled with the preprocessor symbol YYDEBUG defined. The amount of 
diagnostic output is controlled by an external variable yydebug. If it is 2, the parser prints out the name of 
each token returned by yylex and each reduction. If it is 1, the parser prints out the reductions, and if it is 0, 
the parser only reports errors. 


If the -v flag is given, the file y.output is prepared, which contains a description of the parsing tables and a 
report on conflicts generated by ambiguities in the grammar. 


If the -d flag is used, the file y.tab.h is generated with the define statements that associate the yacc-assigned 
‘token codes’ with the user-declared ‘token names’. This allows source files other than y.tab.c to access the 
token codes. 


The prefix y. for the files y.tab.c y.tab.h, y.debug, and y.output can be changed to stem by the -s flag. 


Eyacc is an old version of yacc, with systematic error recovery. It is used in pascal(1). 


FILES 
y.output 
y.tab.c 
y.tab.h defines for token names 
y.debug 
y.tmp.?????? temporary file 
y.acts.????? temporary file 
/usr/lib/yaccparparser prototype for C programs 
Mib/liby.a library with default ‘main’ and ‘yyerror’ 
SEE ALSO 
lex(1) 
LR Parsing by A. V. Aho and S. C. Johnson, Computing Surveys, June, 1974. 
YACC — Yet Another Compiler Compiler by S. C. Johnson. 
Susan L. Graham, Charles B. Haley, and W. N. Joy, Practical LR Error Recovery, SIGPLAN Conference 
on Compiler Construction, August, 1979. 
DIAGNOSTICS 
The number of reduce-reduce and shift-reduce conflicts is reported on the standard output; a more detailed 
report is found in the y.output file. Similarly, if some rules are not reachable from the start symbol, this is 
also reported. 
BUGS 
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The parser may not have full information when it prints out y.debug so that the names of the tokens 
returned by yylex may be missing. 
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NAME 

intro, errno — introduction to system calls and error numbers 
SYNOPSIS 

#include <errno.h> 
DESCRIPTION 
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Section 2 of this manual describes all the entries into the system kernel. 


Calls that deal with the file system refer to directory entries by name. In order to read or write(2) data on a 
file, the file must be opened (open, pipe, creat(2)); an open file is known by a conventional integer value 
called a ‘file descriptor’. Certain open files admit control operations that alter their behavior; see in particu- 
lar ioctl, stream, and ttyld(A). 


Most system calls have an error return. An error condition is indicated by an otherwise impossible returned 
value. Almost always this is —1; the individual sections specify the details. An error number is also made 
available in the external variable errno. Errno is not cleared on successful calls, so it should be tested only 
after an error has occurred. 


There is a table of messages associated with each error, and a routine for printing the message; see 
perror(3). The possible error numbers are not recited with each writeup in section 2, since many errors are 
possible for most of the calls. Here is a list of the error numbers, their names as defined in <errno.h>, and 
the messages available using perror. 


0 Error 0 
Unused. 


1 EPERM Not owner 
Typically this error indicates an attempt to modify a file in some way forbidden except to its owner 
or super-user. It is also returned for attempts by ordinary users to do things allowed only to the 
super-user. 


2 ENOENT No such file or directory 
This error occurs when a file name is specified and the file should exist but doesn’t, or when one of 
the directories in a path name does not exist. 


3 ESRCH No such process 
The process whose number was given to kill does not exist, or is already dead. 


4 EINTR Interrupted system call 
An asynchronous signal (such as interrupt or quit), which the user has elected to catch, occurred 
during a system call. If execution is resumed after processing the signal, it will appear as if the 
interrupted system call returned this error condition. 


5 EIO 1/O error 
Some physical I/O error occurred during a read or write. This error may in some cases occur on a 
call following the one to which it actually applies. 


6 ENXIO No such device or address 
I/O on a special file refers to a subdevice which does not exist, or beyond the limits of the device. 
It may also occur when, for example, a tape drive is not dialed in or no disk pack is loaded on a 
drive. 


7 E2BIG Arg list too long 
An argument list longer than 10240 bytes is presented to exec. 


8 ENOEXEC Exec format error 
A request is made to execute a file which, although it has the appropriate permissions, does not 
start with a valid magic number, see a.out(5). 


9 EBADF Bad file number 
Either a file descriptor refers to no open file, or a read (resp. write) request is made to a file which 


INTRO (2) 


10 


1 


12 


13 


14 


15 


16 


17 


18 


19 


20 


2 


are 


22 


23 


24 


25 


26 


Eighth Edition INTRO(2) 


is open only for writing (resp. reading). 


ECHILD No children 
Wait and the process has no living or unwaited-for children. 


EAGAIN No more processes 
In a fork, the system’s process table is full or the user is not allowed to create any more processes. 


ENOMEM Not enough core 
During an exec or break, a program asks for more core than the system is able to supply. This is 
not a temporary condition; the maximum core size is a system parameter. The error may also 
occur if the arrangement of text, data, and stack segments requires too many segmentation regis- 
ters. 


EACCES Permission denied 
An attempt was made to access a file in a way forbidden by the protection system. 


EFAULT Bad address 
The system encountered a hardware fault in attempting to access the arguments of a system call. 


ENOTBLK Block device required 
A plain file was mentioned where a block device was required, e.g. in mount. 


EBUSY Mount device busy 
An attempt to mount a device that was already mounted or an attempt was made to dismount a 
device on which there is an active file directory (open file, current directory, mounted-on file, 
active text segment). 


EEXIST File exists 
An existing file was mentioned in an inappropriate context, e.g. link. 


EXDEV Cross-device link 
A link to a file on another device was attempted. 


ENODEV No such device 
An attempt was made to apply an inappropriate system call to a device; e.g. read a write-only 
device. 


ENOTDIR Not a directory 
A non-directory was specified where a directory is required, for example in a path name or as an 
argument to chdir. 


EISDIR Is a directory 
An attempt to write on a directory. 


EINVAL Invalid argument 
Some invalid argument: dismounting a non-mounted device, mentioning an unknown signal in 
signal, reading or writing a file for which seek has generated a negative pointer. Also set by math 
functions, see intro(3). 


ENFILE File table overflow 
The system’s table of open files is full, and temporarily no more opens can be accepted. 


EMFILE Too many open files 
The limit is 128 per process. 


ENOTTY Not a typewriter 


The file mentioned in ioctl is not a terminal or one of the other devices to which these calls apply. 


ETXTBSY Text file busy 
An attempt to execute a pure-procedure program which is currently open. Also an attempt to open 
for writing a pure-procedure program that is being executed. 
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EFBIG File too large 
The size of a file exceeded the maximum (about 10° bytes). 


ENOSPC No space left on device 
During a write to an ordinary file, there is no free space left on the device. 


ESPIPE Mlegal seek 
An Iseek was issued to a pipe or other non-seekable device. 


EROFS Read-only file system 
An attempt to modify a file or directory was made on a device mounted read-only. 


EMLINK Too many links 
An attempt to make more than 32767 links to a file. 


EPIPE Broken pipe 
A write on a pipe for which there is no process to read the data. This condition normally generates 
a signal; the error is returned if the signal is ignored. 


EDOM Math argument 
The argument of a function in the math package (3M) is out of the domain of the function. 
ERANGE Result too large 


The value of a function in the math package (3M) is unrepresentable within machine precision. 


ELOOP Link loop 
An endless cycle of symbolic links was encountered. 


intro(3) 


BUGS 


ETXTBSY should happen only when a text file is open for writing. 
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NAME 


access — determine accessibility of file 


SYNOPSIS 


access(name, mode) 
char *name; 


DESCRIPTION 


Access checks the given file name for accessibility according to mode, which is 4 (read), 2 (write) or 1 (exe- 
cute) or a combination thereof. Specifying mode 0 tests whether the directories leading to the file can be 
searched and the file exists. 


An appropriate error indication is returned if name cannot be found or if any of the desired access modes 
would not be granted. On disallowed accesses —1 is returned and the error code is in errno. 0 is returned 
from successful tests. 


The user and group IDs with respect to which permission is checked are the real UID and GID of the pro- 
cess, so this call is useful to set-UID programs. 


Notice that it is only access bits that are checked. A directory may be announced as writable by access, but 
an attempt to open it for writing will fail (although files may be created there); a file may look executable, 
but exec will fail unless it is in proper format. 


SEE ALSO 
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NAME 

acct — turn accounting on or off 
SYNOPSIS 

acct(file) 


char *file; 


DESCRIPTION 
The system is prepared to write a record in an accounting file for each process as it terminates. This call, 
with a null-terminated string naming an existing file as argument, turns on accounting; records for each ter- 
minating process are appended to file. An argument of 0 causes accounting to be turned off. 


The accounting file format is given in acct(5). 
SEE ALSO 
acct(5), sa(8) 


DIAGNOSTICS 
On error —1 is returned. The file must exist and the call may be exercised only by the super-user. It is erro- 
neous to try to turn on accounting when it is already on. 


BUGS 
No accounting is produced for programs running when a crash occurs. In particular nonterminating pro- 
grams are never accounted for. 
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NAME 
alarm — schedule signal after specified time 
SYNOPSIS 
alarm(seconds) 
unsigned seconds; 
DESCRIPTION 
Alarm causes signal SIGALRM, see signal(2), to be sent to the invoking process in a number of seconds 
given by the argument. Unless caught or ignored, the signal terminates the process. 


Alarm requests are not stacked; successive calls reset the alarm clock. If the argument is 0, any alarm 
request is canceled. Because the clock has a 1-second resolution, the signal may occur up to one second 
early; because of scheduling delays, resumption of execution of when the signal is caught may be delayed 
an arbitrary amount. The longest specifiable delay time is 2147483647 seconds. 


The return value is the amount of time previously remaining in the alarm clock. 


SEE ALSO 
pause(2), signal(2), sleep(3) 
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NAME 
brk, sbrk, break — change core allocation 


SYNOPSIS 
char *brk(addr) 


char *sbrk(incr) 


DESCRIPTION 
Brk sets the system’s idea of the lowest location not used by the program (called the break) to addr 
(rounded up to the next multiple of 64 bytes on a PDP11 and 1024 bytes on a VAX). Locations not less 
than addr and below the stack pointer are not in the address space and will thus cause a memory violation if 
accessed. 


In the alternate function sbrk, incr more bytes are added to the program’s data space and a pointer to the 
start of the new area is returned. (Rounding occurs as with brk, but a nominal break is remembered, so 
rounding does not accumulate.) 


When a program begins execution via exec the break is set at the highest location defined by the program 
and data storage areas. Ordinarily, therefore, only programs with growing data areas need to use break. 


SEE ALSO 
exec(2), malloc(3), end(3) 


DIAGNOSTICS 
Zero is returned if the brk could be set; —1 if the program requests more memory than the system limit or if 
too many segmentation registers would be required to implement the break. Sbrk returns —1 if the break 
could not be set. 
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NAME 
chdir, chroot — change working or root directory 

SYNOPSIS 
chdir(dirname) 
char *dirname; 
chroot(dirname) 
char *dirname; 

DESCRIPTION 
Chdir changes the working directory of the invoking process to dirname; chroot changes its root directory. 
The root directory is the starting point when searching for pathnames beginning with ‘/’. The working 
directory is the starting point for pathnames that don’t. The root directory normally points to the system 
root, defined when the system is built. Login(1) initially sets the working directory as specified in the pass- 
word file, passwd (5). 
After chroot, it is impossible to name a file outside the subtree rooted at the current root, provided that the 
current directory is located within the subtree and there are no links pointing outside the subtree (except for 
the entry *..’ in the root directory). 
Chroot may only be used by the super-user. 

SEE ALSO 
sh(1) 

DIAGNOSTICS 
Zero is returned if the directory was changed; —1 is returned if the given pathname doesn’t exist, isn’t a 
directory or can’t be searched, or if chroot is used by other than the super-user. 

BUGS 


Using chroot, it is quite easy to fool set-UID programs about the contents of the password file (for exam- 
ple). 
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NAME 
chmod, fehmod — change mode of file 


SYNOPSIS 
chmod(name, mode) 
char *name; 


fchmod(fd, mode) 


DESCRIPTION 
Chmod changes the mode of the file specified by the null-terminated string name to mode. Fchmod 
changes the mode of an open file referred to by a file descriptor. Modes are constructed by oring together 
some combination of the following: 


04000 set user ID on execution 

02000 set group ID on execution 

01000 save text image after execution 

00400 read by owner 

00200 write by owner 

00100 execute (search on directory) by owner 
00070 read, write, execute (search) by group 
00007 read, write, execute (search) by others 


If an executable file is set up for sharing (this is the default) then mode 1000 prevents the system from 
abandoning the swap-space image of the program-text portion of the file when its last user terminates. 
Ability to set this bit is restricted to the super-user since swap space is consumed by the images. 


Only the owner of a file (or the super-user) may change the mode. Only the super-user can set the 1000 
mode. 


SEE ALSO 
chmod(1) 


DIAGNOSTICS 
Zero is returned if the mode is changed; —1 is returned if name cannot be found or if current user is neither 
the owner of the file nor the super-user. 
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NAME 
chown, fchown — change owner and group of a file 


SYNOPSIS 
chown(name, owner, group) 
char *name; 


fchown(fd, owner, group) 


DESCRIPTION 
Chown changes the owner and group of the file specified by the null-terminated string name. Fchown 
changes the owner and group of an open file specified by file descriptor. Only the super-user may execute 
these calls. 


SEE ALSO 
chown(1), chmod(2), passwd(5) 


DIAGNOSTICS 
Zero is returned if the owner is changed; —1 is returned on illegal owner changes. 
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NAME 
close — close a file 


SYNOPSIS 
close(fildes) 


DESCRIPTION 
Close closes the file associated with a file descriptor. 


Files are closed upon termination of a process, but since there is a limit on the number of open files per pro- 
cess, close is necessary for programs which deal with many files. It is possible to arrange for files to be 
closed by exec(2); see FIOCLEX in ioct#l(2). 


SEE ALSO 
creat(2), open(2), pipe(2), exec(2), ioctl(2) 


DIAGNOSTICS 
Zero is returned if a file is closed; —1 is returned for an unknown file descriptor. 
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NAME 
creat — create a new file 

SYNOPSIS 
creat(name, mode) 
char *name; 

DESCRIPTION 
Creat creates a new file or prepares to rewrite an existing file called name, given as the address of a null- 
terminated string. If the file did not exist, it is given mode mode, as modified by the process’s mode mask 
(see umask(2)). Also see chmod(2) for the construction of the mode argument. 
If the file did exist, its mode and owner remain unchanged but it is truncated to 0 length. 
The file is also opened for writing, and its file descriptor is returned. 
The mode given is arbitrary; it need not allow writing. This feature is used by programs which deal with 
temporary files of fixed names. The creation is done with a mode that forbids writing. Then if a second 
instance of the program attempts a creat, an error is returned and the program knows that the name is unus- 
able for the moment. 

SEE ALSO 
write(2), close(2), chmod(2), umask(2) 

DIAGNOSTICS 
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The value —1 is returned if: a needed directory is not searchable; the file does not exist and the directory in 
which it is to be created is not writable; the file does exist and is unwritable; the file is a directory; the file 
name is too long; there are already too many files open. 
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NAME 


setpgrp, vfork, vadvise, vlimit, vswapon — system calls to be avoided 


SYNOPSIS 


setpgrp(pid, pgrp) 
int getpgrp(pid) 

int vforkQ 
vadvise(how) 

int vlimit(what, limit) 


vswapon(special) 
char *special; 


DESCRIPTION 
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These calls are hangovers from the Berkeley version of the system. Some exist only for system mainte- 
nance purposes; some depend on the virtual memory implementation. None should be used except as a last 
resort. Most are not included in /lib/libe.a. 


Setpgrp sets the process group number for process pid to pgrp; getpgrp returns the process group. 


Vfork is a peculiar variant of fork in which the child borrows the parent’s address space until exec or exit. 
The intent is to avoid copying a large address space. 


Vadvise gives the virtual memory system hints about the paging behaviour of the current process. 


Vlimit sets various resource limits, such as the amount of memory allowed for text and data, and the maxi- 
mum size of core images. 


Vswapon adds the block device special to the pool of swap space. The device must be listed in a table com- 
piled into the kernel; vswapon merely enables it. 


See the Berkeley manual for more information about these calls. 
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NAME 
dup, dup2 — duplicate an open file descriptor 


SYNOPSIS 
dup(fildes) 
int fildes; 
dup2(fildes, fildes2) 
int fildes, fildes2; 


DESCRIPTION 
Given a file descriptor dup allocates another file descriptor synonymous with the original. The new file 
descriptor is returned. 


In the second form of the call, fildes is a file descriptor referring to an open file, and fildes2 is a non- 
negative integer less than the maximum value allowed for file descriptors (currently 127). Dup2 causes 
fildes2 to refer to the same file as fildes. If fildes2 already referred to an open file, it is closed first. 


SEE ALSO 
creat(2), open(2), close(2), pipe(2) 


DIAGNOSTICS 
The value —1 is returned if: the given file descriptor is invalid; there are already too many open files. 
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NAME 


execl, execv, execle, execve, execlp, execvp, exec, exece, environ — execute a file 


SYNOPSIS 


execl(name, arg0, arg], ..., argn, 0) 
char *name, *arg0, *arg],..., *argn; 


execv(name, argv) 
char “name, *argv[]; 


execle(name, arg0, arg], ..., argn, 0, envp) 
char *name, *arg0, *arg], ..., *argn, *envp[]; 


execve(name, argv, envp) 
char “name, *argv[], *envp[]; 


extern char **environ; 


DESCRIPTION 
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Exec in all its forms overlays the calling process with the named file, then transfers to the entry point of the 
core image of the file. There can be no return from a successful exec; the calling core image is lost. 


Files remain open across exec unless explicit arrangement has been made; see ioctl(2). Ignored/held sig- 
nals remain ignored/held across these calls, but signals that are caught (see signal(2)) are reset to their 
default values. 


Each user has a real user ID and group ID and an effective user ID and group ID. The real ID identifies the 
person using the system; the effective ID determines his access privileges. Exec changes the effective user 
and group ID to the owner of the executed file if the file has the ‘set-user-ID’ or ‘set-group-ID’ modes. The 
real user ID is not affected. 


The name argument is a pointer to the name of the file to be executed. If the first two bytes of that file are 
the ASCII string ‘#!’, then the first line of the file is taken to be ASCII and determines the name of the pro- 
gram to execute. The first nonblank string following ‘#!’ in that line is substituted for name. Any second 
string, separated from the first by blanks or tabs, is inserted between the first two arguments (arguments 0 
and 1) passed to the invoked file. 


The argument pointers arg0, argl, ... or the pointers in argv address null-terminated strings. Convention- 
ally argument 0 is the name of the file. 


Execl is useful when a known file with known arguments is being called; the arguments to execl are the 
character strings constituting the file and the arguments. A 0 argument must end the argument list. 


Execv is useful when the number of arguments is unknown in advance; the arguments to execv are the name 
of the file to be executed and a vector of strings containing the arguments. The last argument string must be 
followed by a 0 pointer. 


When a C program is executed, it is called as follows: 


main(argce, argv, envp) 
int argc; 
char **argv, **envp; 


where argc is the argument count and argv is an array of character pointers to the arguments themselves. 
As indicated, argc is conventionally at least one and the first member of the array points to a string contain- 
ing the name of the file. 


Argv is directly usable in another execv because argv[argc] is 0. 


Envp is a pointer to an array of strings that constitute the environment of the process. Each string consists 
of a name, a ‘=’, and a null-terminated value; or a name, a pair of parentheses (), a value bracketed by { and 
}, and by a null. The array of pointers is terminated by a null pointer. The shell sh(1) passes an environ- 
ment entry for each global shell variable defined when the program is called. See environ(5) for some 
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conventionally used names. 


The C run-time start-off routine places a copy of envp in the global cell environ, which is used by execv and 
execl to pass the environment to any subprograms executed by the current program. The exec routines use 
lower-level routines as follows to pass an environment explicitly: 


execve(file, argv, environ); 
execle(file, arg0, argl,..., argn, 0, environ); 


Execlp and execvp are called with the same arguments as execl and execv, but duplicate the shell’s actions 
in searching for an executable file in a list of directories. The directory list is obtained from the environ- 
ment. Exect is the same as execve, except it arranges for a stop to occur on the first instruction of the new 
core image for the benefit of tracers, see proc (4). 


FILES 
/bin/sh shell, invoked if command file found by execlp or execvp 

SEE ALSO 
fork(2), environ(5) 

DIAGNOSTICS 
If the file cannot be found, if it is not executable, if it does not start with a valid magic number (see 
a.out(5)), if maximum memory is exceeded, or if the arguments require too much space, a return constitutes 
the diagnostic; the return value is -1. Even for the super-user, at least one of the execute-permission bits 
must be set for a file to be executed. 

BUGS 


If execvp is called to execute a file that turns out to be a shell command file, and if it is impossible to exe- 
cute the shell, the values of argv[0] and argv[—1] will be modified before return. 
The path search of execlp and execvp does not extend to names substituted by ‘#!’. 
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NAME 
exit — terminate process 


SYNOPSIS 
exit(status) 
int status; 
_exit(status) 
int status; 
DESCRIPTION 
Exit is the normal means of terminating a process. Exit closes all the process’s files and notifies the parent 
process if it is executing a wait. The low-order 8 bits of status are available to the parent process. 


This call can never return. 


The C function exit may cause cleanup actions before the final ‘sys exit’. The function _exit circumvents 


all cleanup, and should be used to terminate a child process after a fork(2) to avoid flushing buffered output 
twice. 


SEE ALSO 
fork(2), wait(2) 
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NAME 
fork — spawn new process 


SYNOPSIS 
forkQ) 


DESCRIPTION 
Fork is the only way new processes are created. The new process’s core image is a copy of that of the 
caller of fork. The only distinction is that the value returned in the old (parent) process is the process ID of 
the new (child) process, while the value returned in the child is 0. Process ID’s range from | to 30,000. 
The process ID is used by wait(2). 


Files open before the fork are shared, and have a common read-write pointer. In particular, this is the way 
that standard input and output files are passed and also how pipes are set up. 


SEE ALSO 
wait(2), exec(2) 


DIAGNOSTICS 
Returns —1 and fails to create a process if: there is inadequate swap space, the user is not super-user and has 
too many processes, or the system’s process table is full. Only the super-user can take the last process-table 
slot. 
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NAME 


getuid, getgid, geteuid, getegid, getpid, getppid — get user, group, or process identity 


SYNOPSIS 


getuid() 
geteuid() 
getgid() 
getegid() 
getpid() 
getppid() 


DESCRIPTION 


Getuid returns the real user ID of the current process, geteuid the effective user ID. The real user ID 
identifies the person who is logged in, in contradistinction to the effective user ID, which determines his 
access permission at the moment. It is thus useful to programs which operate using the ‘set user ID’ mode, 
to find out who invoked them. 


Getgid returns the real group ID, getegid the effective group ID. 


Getpid returns the process ID of the current process. Most often it is used to generate uniquely-named tem- 
porary files. 


Getppid returns the process ID of the parent of the current process. 


SEE ALSO 
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setuid(2), mktemp(3), getlogin(3) 
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NAME 
gmount — mount or remove non-standard file system 
SYNOPSIS 
gmount(fstype, dev, flag [, more]) 
int fstype, flag; 
dev_t dev; 
DESCRIPTION 
Gmount mounts or unmounts a non-standard file system of type fstype. Dev is a device number identifying 
the object mounted; the minor part should be zero. Device numbers are not shared by different filesystem 
types. The filesystem is mounted if flag is zero, dismounted if it is 1. 
Different types of filesystems may require additional arguments when mounting. Only fstype, dev, and flag 
need be given to unmount. 
The possible calls are: 
gmount(1, dev, 0, fildes, name); 
Mount a network filesystem on directory name; fildes is the file descriptor of a stream connected to an 
appropriate server. 
gmount(2, dev, 0); 
Mount the process filesystem. Dev is (stupidly) really a character pointer, and denotes the directory on 
which to mount. 
gmount(3, dev, 0, fildes, name); 
Mount a process on file name; fildes is the file descriptor of a stream. 
DIAGNOSTICS 
Gmount returns 0 if the action occurred; —1 otherwise. 
BUGS 
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Filesystem type 0 (the standard one) should work; it doesn’t. 
The process filesystem should work like everything else. 
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NAME 

ioctl, stty, gtty — miscellaneous stream control operations 
SYNOPSIS 

#include <sgtty.h> 


ioctl(fildes, request, argp) 
struct sgttyb *argp; 


stty(fildes, argp) 
struct sgttyb «argp; 


gtty(fildes, argp) 
struct sgttyb «argp; 


DESCRIPTION 


Toctl performs a variety of functions on special files and streams. The writeups of various devices in sec- 
tion 4 discuss how ioctl applies to them. 


For certain status setting and status inquiries about terminal devices, the functions stty and gity are equiva- 
lent to 


ioctl(fildes, TIOCSETP, argp); 
ioctl(fildes, TIOCGETP, argp); 


respectively; see ttyld(4). 


The following two standard calls, however, apply to any open file. The defined constant NULL has value 
0. 


ioctl(fildes, FIOCLEX, NULL); 
ioctl(fildes, FIONCLEX, NULL); 


The first causes the file to be closed automatically upon a successful exec(2); the second causes the file to 
be left open. 


The following call applies to any stream file descriptor: 

ioctl(fildes, FFONREAD, &count); 
It returns, in the integer count, the number of characters available for reading from /fildes. 
The following calls provide an advisory file locking facility, and apply to any open file: 


ioctl(fildes, FIOALOCK, NULL); 
ioctl(fildes, FFOAUNLOCK, NULL); 
ioctl(fildes, FIOAISLOCK, NULL); 


FIOALOCK either sets an advisory lock, or indicates that this file is already locked by returning —1, with 
errno set to EPERM. 


FIOAUNLOCK either clears an advisory lock, or indicates that the file is locked by another instance of 
open by returning —1, with errno set to EPERM. 


FIOAISLOCK returns 0 for a file with no advisory lock set, | for a file with an advisory lock set using 
another instance of open, or 2 for a file with an advisory lock set on the current instance of open. File 
descriptors belong to the same instance when they are copied by dup(2) or fork(2). Locks are detectable 
only through these calls, and have no effect on IO or ability to open files. 


SEE ALSO 


stty(1), ttyld(4), proc(4), exec(2) 


DIAGNOSTICS 
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Except where otherwise stated, 0 is returned if the call is successful; —1 if the file descriptor does not refer 
to the kind of file for which it was intended, or if request attempts to modify the state of an unwritable file. 
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BUGS 
Strictly speaking, since ioctl may be extended in different ways to devices with different properties, argp 


should have an open-ended declaration like 
union { struct sgttyb ...3... } *argp; 


The important thing is that the size is fixed by ‘struct sgttyb’. 
Toctl requests vary among UNIX systems; undisciplined use is likely to compromise portability. 
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Eighth Edition KILL(2) 


kill — send signal to a process 


SYNOPSIS 


kill(pid, sig) 


DESCRIPTION 


Kill sends the signal sig to the process specified by the process number by pid. See signal(2) for a list of 
signals. 


The sending and receiving processes must have the same effective user ID, otherwise this call is restricted 
to the super-user. 


If the process number is 0, the signal is sent to all other processes in the sender’s process group; see 
ttyld(A). 


If the process number is —1, and the user is the super-user, the signal is broadcast universally except to pro- 
cesses 0, 1 and 2, the scheduler initialization, and pageout processes, see init(8). 


Processes may send signals to themselves. 


SEE ALSO 


signal(2), kill(1) 


DIAGNOSTICS 
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Zero is returned if the process is killed; —1 is returned if the process does not have the same effective user 
ID and the user is not super-user, or if the process does not exist. 
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NAME 


Eighth Edition LINK(2) 


link, symlink, readlink — link to a file 


SYNOPSIS 


link(namel, name2) 
char *namel1, *name?2; 


symlink(name1, name2) 
char *namel1, *name?2; 


readlink(name, buf, size) 
char *name, «buf; 


DESCRIPTION 


A link to name! is created; the link has the name name2. Either name may be an arbitrary path name. 
After link, name2 is entirely equivalent to name/; it is a directory entry referring to the same file as name/. 


After symlink, name2 is a new symbolic link; when it is encountered in any path name, name/ is substituted 
for name2, and path name parsing continues. If name/ begins with the ‘/’ character, it is interpreted with 
respect to the root directory; if not, it is interpreted with respect to the directory in which name2 resides. 


The readlink call returns the contents of a symbolic link name into buf. No more than size characters are 
returned. If there is room, the returned string will be null-padded. An error is reported if name is not a 
symbolic link. 


SEE ALSO 


In(1), unlink(2), stat(2) 


DIAGNOSTICS 


Page | 


Zero is returned when a link is made; —1 is returned when name/ cannot be found; when name2 already 
exists; when the directory of name2 cannot be written. With link, only the super-user may link to a direc- 
tory. Furthermore, the target must exist in the same file system, and not have too many links. 
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NAME 
Iseek, tell — move read/write pointer 


SYNOPSIS 
long Iseek(fildes, offset, whence) 
long offset; 


long tell(fildes) 


DESCRIPTION 
The file descriptor refers to a file open for reading or writing. The read (resp. write) pointer for the file is 
set as follows: 


If whence is 0, the pointer is set to offset bytes. 
If whence is 1, the pointer is set to its current location plus offset. 
If whence is 2, the pointer is set to the size of the file plus offset. 
The returned value is the resulting pointer location. 
The obsolete function fell (fildes) is identical to Iseek(fildes, OL, 1 ). 


Seeking far beyond the end of a file, then writing, creates a gap or ‘hole’, which occupies no physical space 
and reads as zeros. 


SEE ALSO 
open(2), creat(2), fseek(3) 


DIAGNOSTICS 
—1 is returned for an undefined file descriptor, seek on a pipe, or seek to a position before the beginning of 
file. 


BUGS 
Lseek is a no-op on character special files. 
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NAME 
mkdir, rmdir — make or remove a directory 


SYNOPSIS 
mkdir(name, mode) 
char *name; 


rmdir(name) 
char *name; 


DESCRIPTION 
Mkdir creates a new directory whose name is the null-terminated string pointed to by name. The mode of 
the directory is initialized from mode, modified by the current mode mask (umask(2)). The directory is ini- 
tialized with two entries: . points to the directory itself, .. to its parent. 


Rmdir removes the directory name, which must be empty. 
SEE ALSO 
mkdir(1), rmdir(1), mknod(2) 


DIAGNOSTICS 
Mkdir returns 0 on success, —1 if the directory already exists or if the user has no write permissions in the 
parent directory. 


Rmdir returns 0 on success, —1 if the directory doesn’t exist, isn’t empty, isn’t a directory, or is the root of a 
filesystem. 


BUGS 
Rmdir will happily remove a non-empty directory, leaving any files therein orphaned. This is easy to fix, 
but nobody has bothered. 
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NAME 
mknod — make a directory or a special file 

SYNOPSIS 
mknod(name, mode, addr) 
char *name; 

DESCRIPTION 
Mknod creates a new file whose name is the null-terminated string pointed to by name. The mode of the 
new file (including directory and special file bits) is initialized from mode. (The protection part of the 
mode is modified by the process’s mode mask; see umask(2)). The first block pointer of the i-node is ini- 


tialized from addr. For ordinary files and directories addr is normally zero. In the case of a special file, 
addr specifies which special file. 


Mknod may be invoked only by the super-user. 


SEE ALSO 
mkdir(1), mknod(1), filsys(5) 


DIAGNOSTICS 
Zero is returned if the file has been made; —1 if the file already exists or if the user is not the super-user. 
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NAME 
mount, umount — mount or remove file system 

SYNOPSIS 
mount(special, name, rwflag) 
char «special, *name; 
umount(special) 
char *special; 

DESCRIPTION 
Mount announces to the system that a removable file system has been mounted on the block-structured spe- 
cial file special; from now on, references to file name will refer to the root file on the newly mounted file 
system. Special and name are pointers to null-terminated strings containing the appropriate path names. 
Name must exist already. Name must be a directory (unless the root of the mounted file system is not a 
directory). Its old contents are inaccessible while the file system is mounted. 
The rwflag argument determines whether the file system can be written on; if it is 0 writing is allowed, if 
non-zero no writing is done. Physically write-protected and magnetic tape file systems must be mounted 
read-only or errors will occur when access times are updated, whether or not any explicit write is attempted. 
Umount announces to the system that the special file is no longer to contain a removable file system. The 
associated file reverts to its ordinary interpretation. 

SEE ALSO 
mount(8) 

DIAGNOSTICS 
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Mount returns 0 if the action occurred; —1 if special is inaccessible or not an appropriate file; if name does 
not exist; if special is already mounted; if name is in use; or if there are already too many file systems 
mounted. 


Umount returns 0 if the action occurred; —1 if the special file is inaccessible or does not have a mounted file 
system, or if there are active files in the mounted file system. 
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NAME 
nap — suspend execution for a short interval 


SYNOPSIS 
nap(ticks) 


DESCRIPTION 
Nap suspends execution of the current process for ticks/HZ seconds, where HZ is 50 or 60 depending on 
your locality. The time may be at most two seconds. 


SEE ALSO 
alarm(2), sleep(3) 
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NAME 
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nice — set program priority 


SYNOPSIS 


nice(incr) 


DESCRIPTION 


The scheduling priority of the process is augmented by incr. Positive priorities get less service than nor- 
mal. Priority 10 is recommended to users who wish to execute long-running programs without flak from 
the administration. 


Negative increments are ignored except on behalf of the super-user. The priority is limited to the range —20 
(most urgent) to 20 (least). 


The priority of a process is passed to a child process by fork(2). For a privileged process to return to nor- 
mal priority from an unknown state, nice should be called successively with arguments —40 (goes to priority 
—20 because of truncation), 20 (to get to 0), then 0 (to maintain compatibility with previous versions of this 
call). 


SEE ALSO 
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nice(1) 
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NAME 
open — open for reading or writing 


SYNOPSIS 
open(name, mode) 
char *name; 


DESCRIPTION 
Open opens the file name for reading (if mode is 0), writing (if mode is 1) or for both reading and writing (if 
mode is 2). Name is the address of a string of ASCII characters representing a path name, terminated by a 
null character. 


The file is positioned at the beginning (byte 0). The returned file descriptor must be used for subsequent 
calls for other input-output functions on the file. 


SEE ALSO 
creat(2), read(2), write(2), dup(2), close(2) 


DIAGNOSTICS 
The value —1 is returned if the file does not exist, if one of the necessary directories does not exist or is 
unreadable, if the file is not readable (resp. writable), the name is too long, or if too many files are open. 


BUGS 
It should be possible to optionally open files for writing with exclusive use, and to optionally call open 
without the possibility of hanging waiting for carrier on communication lines. 
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NAME 
pause — stop until signal 


SYNOPSIS 
pause() 


DESCRIPTION 
Pause never returns normally. It is used to give up control while waiting for a signal from kill(2) or 
alarm(2). Upon termination of a signal handler started during a pause, the pause call will return. 


SEE ALSO 
kill(1), kill(2), alarm(2), signal(2), setjmp(3) 
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NAME 
pipe — create an interprocess channel 


SYNOPSIS 
pipe(fildes) 
int fildes[2]; 
DESCRIPTION 
The returned file descriptors are the ends of pair of cross-connected streams (See stream(4)). Data written 
via fildes[1] is available for reading via fildes [0] and vice versa. 


It is assumed that after the pipe has been set up, two (or more) cooperating processes (created by subse- 
quent fork calls) will pass data through the pipe with read and write calls. The record structure induced by 
write calls is maintained by a pipe and is visible to a reader, provided no line disciplines modules have been 
pushed into the pipe stream; see write (2). 


The Shell has a syntax to set up a linear array of processes connected by pipes. 


Write calls on a one-ended pipe raise signal SIGPIPE. Read calls on a one-ended pipe with no data in it 
return an end-of-file for the first several attempts, then raise SIGPIPE. 


SEE ALSO 
sh(1), read(2), write(2), fork(2) 


DIAGNOSTICS 
The function value zero is returned if the pipe was created; —1 if too many files are already open. 


BUGS 
Should too much buffering be necessary in any pipeline among a loop of processes, deadlock will occur. 
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NAME 
profil — execution time profile 


SYNOPSIS 
profil(buff, bufsiz, offset, scale) 
char «buff; 
int bufsiz, offset, scale; 


DESCRIPTION 
Buff points to an area of core whose length (in bytes) is given by bufsiz. After this call, the user’s program 
counter (pc) is examined each clock tick (60th second); offset is subtracted from it, and the result multiplied 
by scale. If the resulting number corresponds to a word inside buff, that word is incremented. 


The scale is interpreted as an unsigned, fixed-point fraction with binary point at the left: 0177777(8) gives a 
1-1 mapping of pe’s to words in buff; 077777(8) maps each pair of instruction words together. 02(8) maps 
all instructions onto the beginning of buff (producing a non-interrupting core clock). 


Profiling is turned off by giving a scale of 0 or 1. It is rendered ineffective by giving a bufsiz of 0. 
Profiling is turned off when an exec is executed, but remains on in child and parent both after a fork. 
Profiling may be turned off if an update in buff would cause a memory fault. 


SEE ALSO 
monitor(3), prof(1) 


BUGS 
Profiling does not work for interpreters; if a signal were given to a process when its cpu-time clock ticked 
then profiling interpreters would be possible. 
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NAME 
read — read from file 


SYNOPSIS 
read(fildes, buffer, nbytes) 
char «buffer; 


DESCRIPTION 
Read causes data to be read from the open file associated with the file descriptor. Buffer is the location of 
nbytes contiguous bytes into which the input will be placed. It is not guaranteed that all nbytes bytes will 
be read; for example if the file refers to a terminal at most one line will be returned. In any event the num- 
ber of characters read is returned. 


A return value of 0 is conventionally interpreted as end of file. If more data is subsequently written on the 
open file by another process, then a further read will return it. 


SEE ALSO 
open(2), creat(2), dup(2), pipe(2), select(2) 


DIAGNOSTICS 
As mentioned, 0 is returned when the end of the file has been reached. If the read was otherwise unsuccess- 
ful the return value is -1. Many conditions can generate an error: physical I/O errors, bad buffer address, 
preposterous nbytes, file descriptor not that of an input file. 
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NAME 
reboot — reboot system or halt processor 


SYNOPSIS 
#include <sys/reboot.h> 


reboot(how) 
int how; 


DESCRIPTION 
Reboot reboots or halts the system. Various options are specified in how: 


RB_PANIC Cause a crash dump to be written. 

RB_NOSYNC Don’t finish pending disk writes (a la sync (2)). 

RB HALT Don’t reboot; leave the processor in a tight loop with interrupts disabled. 
RB SINGLE _ Reboot single-user. 

RB_ASKNAME Arrange for the boot program to ask the name of the system to be booted. 


By default, disk writes are finished, and the system is rebooted multi-user from /unix on unit 0 of the root 
device. 


SEE ALSO 
crash(8), init(8), reboot(8) 


BUGS 
Of dubious utility; it’s better just to use the console. Most of the flags are silly. 
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NAME 
select — synchronous I/O multiplexing 


SYNOPSIS 
#include <sys/types.h> 
int select(nfds, readfds, writefds, milli); 
fd_set *readfds, «writefds; 

DESCRIPTION 
Select examines the IO descriptors specified by the bit masks readfds and writefds to see if they are ready 
for reading and/or writing respectively and returns, in place, a mask of those descriptors which are ready. 
Only descriptors 0 through nfds—1 are examined. The total number of ready descriptors is returned. 


File descriptors referring to ordinary files and non-stream special files always appear ready. 


Milli is the maximum number of milliseconds to wait before giving up if no descriptors come active. If no 
maximum wait is desired a very large integer can be given. If milli is 0, select returns whatever information 
is available without blocking. 


Either readfds or writefds may be null if no descriptors are interesting. Readfds and writefds point to a 
structure containing a simple bit mask: file descriptor f is represented by the bit l<<(f%N) in 
readfds—>fds_bits|{f/N], where N is the number of bits in an int (given by the constant expression 
NBBY*NBPW). These macros manipulate the bits of mask s: 


FD_ZERO(s) _ clear all bits 
FD SET(n,s) set bitn 
FD CLR(n,s) clear bit n 
FD_ISSET(n,s) test bit n 


BUGS 
Milli is rounded up to the nearest second. 
Select is intended for use with streams; it does not work with non-stream special files that can block. 
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NAME 
setuid, setgid — set user and group ID 


SYNOPSIS 
setuid(uid) 


setgid(gid) 


DESCRIPTION 
The user ID (group ID) of the current process is set to the argument. Both the effective and the real ID are 
set. These calls are only permitted to the super-user or if the argument is the real or effective ID. 


SEE ALSO 
getuid(2) 


DIAGNOSTICS 
Zero is returned if the user (group) ID is set; —1 is returned otherwise. 
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NAME 


signal — catch or ignore signals 


SYNOPSIS 


#include <signal.h> 


int («signal(sig, func))() 
int (*func)Q; 


DESCRIPTION 
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A signal is generated by some abnormal event, initiated either by user at a terminal (quit, interrupt), by a 
program error (bus error, etc.), or by request of another program (kill). Normally all signals cause termina- 
tion of the receiving process, but a signal call allows them either to be ignored or to cause an interrupt to a 
specified location. Here is the list of signals with names as in the include file. 


SIGHUP 1 hangup 
SIGINT 2 interrupt 
SIGQUIT 3* quit 
SIGILL 4* illegal instruction (not reset when caught) 
SIGTRAP 5* trace trap (not reset when caught) 
SIGIOT 6* IOT instruction 
SIGEMT = 7* EMT instruction 
SIGFPE 8* floating point exception 
SIGKILL 9 __ kill (cannot be caught or ignored) 
SIGBUS 10* bus error 
SIGSEGV _11* segmentation violation 
SIGSYS 12* bad argument to system call 
SIGPIPE 13 write on a pipe with no one to read it 
SIGALRM 14 alarm clock 
SIGTERM 15 _ software termination signal 
16 unassigned 
SIGSTOP — 17+ stop (cannot be caught, held or ignored) 
SIGCONT  19# continue a stopped process 
SIGCHLD 20# child has stopped or exited 


* causes core image if not caught or ignored 
+ suspends process until SIGCONT or PIOCRUN, see proc(4) 
# ignored if not caught 


Signals 1 through NSIG, defined in the include file, exist. Those not listed above have no conventional 
meaning in this system. (Berkeley systems use 1-15 and 17-25). 


If func is SIG_DFL, the default action for signal sig is reinstated; this default is termination, sometimes 
with a core image. If func is SIG_IGN the signal is ignored. Otherwise when the signal occurs func will be 
called with the signal number as argument. A return from the function will continue the process at the 
point it was interrupted. 


Except as indicated, a signal is reset to SIG _DFL after being caught. Thus if it is desired to catch every 
such signal, the catching routine must issue another signal call. 


When a caught signal occurs during certain system calls, the call terminates prematurely. In particular this 
can occur during read or write(2) on a slow device (like a typewriter; but not a file); and during pause and 
wait(2). When such a signal occurs, the saved user status is arranged so that when return from the signal- 
catching takes place, it will appear that the system call returned an error status. The user’s program may 
then, if it wishes, re-execute the call. 


The value of signal is the previous (or initial) value of func for the particular signal. 
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After a fork(2) the child inherits all signals. Exec(2) resets all caught signals to default action. 


SEE ALSO 
kill(1), kill(2), setjmp(3), proc(4) 


DIAGNOSTICS 
The value (int)—1 is returned if the given signal is out of range. 


BUGS 
Unadvertised and unsupported func arguments can radically and permanently change the behavior of sig- 
nals. 
Trap syndromes should be distinguishable by extra arguments to the signal handler. 
If a repeated signal arrives before the last one can be reset, there is no chance to catch it. 
The type specification of the routine and its func argument are problematical. At the very least the type 
should be ‘void (*)(Q’. 
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NAME 


stat, Istat, fstat — get file status 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/stat.h> 


stat(name, buf) 
char *name; 
struct stat «buf; 


Istat(name, buf) 
char *name; 
struct stat «buf; 


fstat(fildes, buf) 
struct stat «buf; 


DESCRIPTION 
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Stat obtains detailed information about a named file. Lstat obtains the same information, but in the case of 
a symbolic link (see link(2)), supplies information about the link itself. Fstat obtains the same information 
about an open file known by a file descriptor. 


Name points to a null-terminated string naming a file; buf is the address of a buffer into which information 
is placed concerning the file. It is unnecessary to have any permissions at all with respect to the file, but all 
directories leading to the file must be searchable. The layout of the structure pointed to by buf is given 
below; st_mode is encoded according to the ‘#define’ statements. 


struct stat 

{ 
dev t st_dev; 
ino t st_ino; 
unsigned short st_mode; 
short st_nlink; 
short st_uid; 
short st_ gid; 
dev t st_rdev; 
off t st_size; 
time_t st_atime; 
time_t st_mtime; 
time_t st_ctime; 


bs 


#define S_IFMT — 0170000 /* type of file */ 

#define S_IFDIR 0040000 = /* directory */ 

#define S_IFCHR 0020000 = /* character special */ 

#define S_IFBLK 0060000 = /* block special */ 

#define S_IFREG 0100000 = /* regular */ 

#define S_IFLNK 0120000 /* symbolic link */ 

#define S_ISUID 0004000 /* set user id on execution */ 

#define S_ISGID 0002000 /* set group id on execution */ 
#define S_ISVTX 0001000 /* save swapped text even after use */ 
#define S_IREAD 0000400 /* read permission, owner */ 

#define S_IWRITE 0000200 = /* write permission, owner */ 

#define S_IEXEC 0000100 /* execute/search permission, owner */ 


The mode bits 0000070 and 0000007 encode group and others permissions (see chmod(2)). The defined 
types, ino_t, off t, time_t, name various width integer values; dev_t encodes major and minor device 
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numbers; their exact definitions are in the include file <sys/types.h> (see types(5)). 


St_atime is the time the file was last read. For reasons of efficiency, it is not set when a directory is 
searched, although this would be more logical. St_mtime is the time the file was last written or created. It 
is not set by changes of owner, group, link count, or mode. St_ctime is set both by writing and and by 
changing the i-node. 


SEE ALSO 
Is(1), chmod(2), filsys(5) 


DIAGNOSTICS 
Zero is returned if a status is available; —1 if the file cannot be found. 
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NAME 
stime, settod — set time 


SYNOPSIS 
stime(tp) 
long *tp; 


long settod(toy) 
long toy; 


DESCRIPTION 
Stime sets the system’s idea of the time and date. Time, pointed to by tp, is measured in seconds from 0000 
GMT Jan 1, 1970. 


Settod sets the VAX hardware time-of-year clock to toy, and returns the previous value. When the system 
is booted, the system’s time is set from the time-of-year clock; while the system is running, the time-of-year 
clock is examined periodically, and the system’s time adjusted slowly if necessary to make the two agree. 


Only the super-user may use these calls. 


SEE ALSO 
date(1), time(2), ctime(3) 


DIAGNOSTICS 
Zero is returned if the time was set; —1 if user is not the super-user. 
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NAME 

sync — update super-block 
SYNOPSIS 

sync() 
DESCRIPTION 


Sync causes all information in core memory that should be on disk to be written out. This includes 
modified super blocks, modified i-nodes, and delayed block I/O. 


It should be used by programs which examine a file system, for example icheck, df, etc. It is mandatory 
before a boot. 


SEE ALSO 
sync(8), update(8) 


BUGS 
The writing, although scheduled, is not necessarily complete upon return from sync. 
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NAME 
syscall — indirect system call 


SYNOPSIS 
syscall(number, arg, ....) (VAX) 


syscall(number, r0, rl, arg...) (PDP11) 


DESCRIPTION 
Syscall performs the system call whose assembly language interface has the specified number and argu- 
ments. 


On a PDP11 the first two arguments correspond to registers rO and rl, regardless of whether the entry point 
really uses them. 


The 10 value of the system call is returned. 


DIAGNOSTICS 
When the C-bit is set, syscall returns —1 and sets the external variable errno (see intro(2)). 


BUGS 
There is no way to simulate system calls such as pipe(2), which return values in register rl. 


Page | 


TIME (2) Eighth Edition TIME(2) 


NAME 


time, ftime — get date and time 


SYNOPSIS 


long time(0) 


long time(tloc) 
long *tloc; 


#include <sys/types.h> 
#include <sys/timeb.h> 
ftime(tp) 

struct timeb «tp; 


DESCRIPTION 


Time returns the time since 00:00:00 GMT, Jan. 1, 1970, measured in seconds. 
If tloc is nonnull, the return value is also stored in the place to which floc points. 
The ftime entry fills in a structure pointed to by its argument, as defined by <sys/timeb.h>: 


/* 
* Structure returned by ftime system call 
*/ 
struct timeb 
{ 
time t time; 
unsigned short millitm; 
short timezone; 
short dstflag; 
}s 
The structure contains the time since the epoch in seconds, up to 1000 milliseconds of more-precise inter- 
val, the local time zone (measured in minutes of time westward from Greenwich), and a flag that, if 
nonzero, indicates that Daylight Saving time applies locally during the appropriate part of the year. 


SEE ALSO 
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date(1), stime(2), ctime(3) 
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NAME 
times — get process times 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/times.h> 


times(buffer) 
struct tms «buffer; 


DESCRIPTION 
Times returns time-accounting information for the current process and for the terminated child processes of 
the current process. All times are in 1/HZ seconds, where HZ is either 50 or 60 depending on your locality. 


This is the structure returned by times: 


/* 
* Structure returned by times() 
*/ 
struct tms { 
time t tms_utime; /* user time */ 
time t tms_stime; /* system time */ 
time t tms_cutime; /* user time, children */ 
time t tms_cstime; /* system time, children */ 
3 
The children times are the sum of the children’s process times and their children’s times. 
SEE ALSO 


time(1), time(2) 


Page | 


UMASK (2) Eighth Edition UMASK(2) 


NAME 

umask — set file creation mode mask 
SYNOPSIS 

umask(complImode) 
DESCRIPTION 


Umask sets a mask used whenever a file is created by creat(2) or mknod(2): the actual mode (see 
chmod(2)) of the newly-created file is the logical and of the given mode and the complement of the argu- 
ment. Only the low-order 9 bits of the mask (the protection bits) participate. In other words, the mask 
shows the bits to be turned off when files are created. 


The previous value of the mask is returned by the call. The value is initially 022 (write access for owner 
only). The mask is inherited by child processes. 


SEE ALSO 
creat(2), mknod(2), chmod(2) 
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NAME 
unlink — remove directory entry 


SYNOPSIS 
unlink(name) 
char *name; 


DESCRIPTION 
Name points to a null-terminated string. Unlink removes the entry for the file pointed to by name from its 
directory. If this entry was the last link to the file, the contents of the file are freed and the file is destroyed. 
If, however, the file was open in any process, the actual destruction is delayed until it is closed, even though 
the directory entry has disappeared. 


SEE ALSO 
rm(1), link(2) 


DIAGNOSTICS 
Zero is normally returned; —1 indicates that the file does not exist, that its directory cannot be written, or 
that the file contains pure procedure text that is currently in use. Write permission is not required on the file 
itself. It is also illegal to unlink a directory (except for the super-user). 
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NAME 
utime — set file times 


SYNOPSIS 
#include <sys/types.h> 
utime(file, timep) 
char *file; 
time_t timep[2]; 
DESCRIPTION 
The utime call uses the ‘accessed’ and ‘updated’ times in that order from the timep vector to set the corre- 
sponding recorded times for file. 


The caller must be the owner of the file or the super-user. The ‘inode-changed’ time of the file is set to the 
current time. 


SEE ALSO 
stat(2) 
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NAME 
wait — wait for process to terminate 

SYNOPSIS 
wait(status) 
int «status; 
wait(0) 

DESCRIPTION 
Wait causes its caller to delay until a signal is received or one of its child processes terminates. If any child 
has died since the last wait, return is immediate; if there are no children, return is immediate with the error 
bit set (resp. with a value of —1 returned). The normal return yields the process ID of the terminated child. 
In the case of several children several wait calls are needed to learn of all the deaths. 
If (int)status is nonzero, the high byte of the short integer (sic) pointed to receives the low byte of the argu- 
ment of exit when the child terminated. The low byte receives the termination status of the process. If inte- 
gers are wider than shorts, the higher-order bytes are undefined. See signal(2) for a list of termination sta- 
tuses (signals); 0 status indicates normal termination. A special status (0177) is returned for a process 
which has stopped but can be restarted; see signal(2). If the 0200 bit of the termination status is set, a core 
image of the process was produced by the system. 
If the parent process terminates without waiting on its children, the initialization process (process ID = 1) 
inherits the children. 

SEE ALSO 
exit(2), fork(2), signal(2), sh(1) 

DIAGNOSTICS 
Returns —1 if there are no children not previously waited for. 

BUGS 
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Status points to an integer; only the low two bytes are meaningful, but all bytes are written. 
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NAME 
write — write on a file 


SYNOPSIS 
write(fildes, buffer, nbytes) 
char «buffer; 


DESCRIPTION 
Write writes data on the open file associated with the file descriptor. 


Buffer is the address of nbytes contiguous bytes which are written on the output file. The number of charac- 
ters actually written is returned. It should be regarded as an error if this is not the same as requested. 


If the open file is being read by another process, data of at most one write will be delivered to any read(2) 
in the other process. In particular, if nbytes = 0, the read will return a count of 0, which is conventionally 
taken to mean end of file. 


Writes which are synchronized with file system blocks are more efficient than others; see filsys (5). 


On some systems write clears the set-user-id bit on a file. This prevents penetration of system security by a 
user who captures a writable set-user-id file that he does not own. 


SEE ALSO 
creat(2), open(2), pipe(2), select(2) 


DIAGNOSTICS 
Returns —1 on error: bad descriptor, buffer address, or count; physical I/O errors. 
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NAME 


DESCRIPTION 


FILES 


DIAGNOSTICS 
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intro — introduction to library functions 


SYNOPSIS 
#include <stdio.h> 


#include <math.h> 


This section describes functions that may be found in various libraries, other than those functions that 
directly invoke UNIX system primitives, which are described in section 2. Functions are divided into vari- 
ous libraries distinguished by the section number at the top of the page: 


(3) 


(3F) 


(3M) 


(3S) 


(3X) 


These functions, together with those of section 2 and those marked (3S) and (3M), constitute library 
libc, which is automatically loaded by the C compiler cc(1) and the Fortran compiler f77(1). The 
link editor /d(1) searches this library under option -Ic . Declarations for some of these functions 
may be obtained from include files indicated on the appropriate pages. 


These functions are in the Fortran library, /ibF'77, automatically loaded by the Fortran compiler, and 
searched under option -IF77 of the link editor. 


These functions constitute the math library, part of libc. (On other systems they must be loaded by 
-Im). Declarations for these functions may be obtained from the include file <math.h>. 


These functions constitute the ‘standard IO package’, see stdio(3), part of libc already mentioned. 
Declarations for these functions may be obtained from the include file <stdio.h>. 


Various specialized libraries have not been given distinctive captions. Files in which such libraries 
are found are named on appropriate pages. 


Nib/libc.a 


SEE ALSO 
stdio(3), nm(1), 1d(1), cc(1), £77(1), intro(2) 


Functions in the math library (3M) may return conventional values when the function is undefined for the 
given arguments or when the value is not representable. In these cases the external variable errno (see 
intro(2)) is set to the value EDOM or ERANGE, defined in the include file <math.h>. 
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NAME 
abort — generate a fault 


DESCRIPTION 
Abort executes an instruction which is illegal in user mode. This causes a signal that normally terminates 
the process with a core dump, which may be used for debugging. 


SEE ALSO 
adb(1), signal(2), exit(2) 


DIAGNOSTICS 
Usually ‘abort — core dumped’ from the shell. 


Page | 


ARITH (3) Eighth Edition ARITH(3) 


NAME 


abs, sgn, gcd, lcm, min, max — integer arithmetic functions: absolute value, sign, greatest common divisor, 
least common multiple, minimum, maximum 


SYNOPSIS 
abs(a) 
sgn(a) 
gcd(a, b) 
long Icm(a, b) 
min(a, b) 
max(a, b) 


DESCRIPTION 
Abs returns the absolute value of a. 


Sgn returns —1, 0, 1, according as a<0, a=0, a>0. 
Gcd returns the largest positive integer that divides both a and b, except that gcd(0, 0) = 0. 
Lem satisfies 
Icm(a, b) = abs(ab/gcd(a, b)) 
except that Icm(0, 0) = 0. 
Min (max) returns the minimum (maximum) of a and b. 


SEE ALSO 
floor(3) for fabs 
DIAGNOSTICS 
Abs and gcd return —X, the most negative integer, when the true result is the unrepresentable value X. 


BUGS 
The result of /cm is undefined when it doesn’t fit in a long. 
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NAME 
assert — program verification 


SYNOPSIS 
#include <assert.h> 


assert(expression) 


DESCRIPTION 
Assert is a macro that indicates expression is expected to be true at this point in the program. It causes an 
exit(2) with a diagnostic comment on the standard output when expression is false (0). Compiling with the 
cc(1) option -DNDEBUG effectively deletes assert from the program. 


DIAGNOSTICS 
“Assertion failed: file fline n.’ F is the source file and n the source line number of the assert statement. 
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NAME 
atof, atoi, atol - convert ASCII to numbers 


SYNOPSIS 
double atof(nptr) 
char *nptr; 
int atoi(mptr) 
char *nptr; 
long atol(nptr) 
char *nptr; 
DESCRIPTION 
These functions convert a string pointed to by nptr to floating, integer, and long integer representation 
respectively. The first unrecognized character ends the string. 


Atof recognizes an optional string of tabs and spaces, then an optional sign, then a string of digits optionally 
containing a decimal point, then an optional ‘e’ or ‘E’ followed by an optionally signed integer. 


Atoi and atol recognize an optional string of tabs and spaces, then an optional sign, then a string of digits. 


SEE ALSO 
scanf(3) 


BUGS 
There are no provisions for overflow. 
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NAME 


bopen, bclose, bseek, bfirst, bkey, breclen, bread, bdelete, bwrite — compressed B-tree subroutines 


SYNOPSIS 


#include <cbt.h> 

bfile *bopen(name, typ) char «name; 

void bclose(b) bfile *b; 

bseek(b, key) bfile *b; mbuf key; 

bfirst(b) bfile «b; 

mbuf bkey(b) bfile «b; 

breclen(b) bfile *b; 

bread(b, key, val) bfile *b; mbuf «key, «val; 
bdelete(b, key) bfile *b; mbuf key; 
bwrite(b, key, val) bfile *b; mbuf key, val; 


DESCRIPTION 


FILES 
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These functions manipulate files of key/value records. Such files are created by cbt(1). To load the func- 
tions use /d(1) option —-Icbt. 


The records occur sorted by their keys, which must be distinct. Both keys and values are arrays of charac- 
ters accessed through the data type ‘mbuf”: 


typedef struct { 

char *mdata; /* pointer to the data */ 

short mlen; /* number of bytes in the data */ 
} mbuf; 


Bopen attempts to open a named B-tree, and if successful establishes a read pointer pointing to the begin- 
ning of the file and returns a pointer to be used in calling the other routines. Typ is 0 for read-only or 2 for 
read-write. Bopen returns a descriptor that identifies the file to the other functions. 


Bclose closes a B-tree. 


Bseek positions the read pointer of the file to the record whose key is the first not less than key. The routine 
returns | if key is in the file, EOF if key is greater than any key in the file, and 0 otherwise. 


Bfirst sets the read pointer to the beginning of the file. It has the same error return as bseek. 


Bkey returns the current key. The element mdata of the returned structure is 0 on errors, otherwise it points 
to a critical static buffer. 


Breclen returns the length of the value part of the current record. 


Bread reads the value at the read pointer into the space pointed to by val—>mdata, places its length in 
val—>mlen, and advances the read pointer to the record with the next greater key. If key is not 0 the key of 
the record is read into the space pointed to by key—>mdata and its length is placed in key->mlen. Bread 
returns 0 if successful. 


Bdelete removes the record with the given key, returning 1 if the record was found, —1 if there was an error, 
and 0 otherwise, The read pointer is left undefined. 


Bwrite writes the given value with the given key, returning 0 if there was no error. An existing record with 
that key will be replaced. The read pointer is left undefined. 


The btree name is stored in files name.T and name.F. 
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SEE ALSO 
cbt(1), dbm(3) 


DIAGNOSTICS 
Routines which return pointers return 0 on errors, routines which return integers return -1. 


BUGS 
The lengths of keys and values are limited. 
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NAME 
chrtab — simple character bitmaps 


SYNOPSIS 
extern char chrtab[95][16]; 


DESCRIPTION 
Chrtab contains 8-by-16 bitmaps for ASCII printing characters. The 16 bytes pointed to by chrtab[c — * ‘] 
are the 16 rows of character c from top to bottom. The bottom row is always empty (has all bits 0). 


SEE ALSO 
plot(3), font(9.5) 
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NAME 


crypt, setkey, encrypt — DES encryption 


SYNOPSIS 


char *crypt(key, salt) 
char «key, *salt; 


setkey(key) 
char *Kkey; 


encrypt(block, edflag) 
char *block; 


DESCRIPTION 


Crypt is the password encryption routine. It is based on the NBS Data Encryption Standard, with variations 
intended (among other things) to frustrate use of hardware implementations of the DES for key search. 


The first argument to crypt is a user’s typed password. The second is a 2-character string chosen from the 
set [a-zA-Z0-9./]. The salt string is used to perturb the DES algorithm in one of 4096 different ways, after 
which the password is used as the key to encrypt repeatedly a constant string. The returned value points to 
the encrypted password, in the same alphabet as the salt. The first two characters are the salt itself. 


The other entries provide (rather primitive) access to the actual DES algorithm. The argument of setkey is a 
character array of length 64 containing only the characters with numerical value 0 and 1. If this string is 
divided into groups of 8, the low-order bit in each group is ignored, leading to a 56-bit key which is set into 
the machine. 


The argument to the encrypt entry is likewise a character array of length 64 containing 0’s and 1’s. The 
argument array is modified in place to a similar array representing the bits of the argument after having 
been subjected to the DES algorithm using the key set by setkey. If edflag is 0, the argument is encrypted; if 
non-zero, it is decrypted. 


SEE ALSO 


BUGS 
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crypt(1), passwd(1), passwd(5), getpass(3) 


The return value points to static data whose content is overwritten by each call. 
Crypt and encrypt are not available outside the United States and Canada. 
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NAME 
ctime, localtime, gmtime, asctime, timezone — convert date and time to ASCII 


SYNOPSIS 
char *ctime(clock) 
long «clock; 


#include <time.h> 


struct tm *localtime(clock) 
long «clock; 


struct tm *gmtime(clock) 
long «clock; 


char *asctime(tm) 
struct tm *tm; 


char *timezone(zone, dst) 


DESCRIPTION 
Ctime converts a time pointed to by clock such as returned by time(2) into ASCII and returns a pointer to a 
26-character string in the following form. All the fields have constant width. 


Sun Sep 16 01:03:52 1973\n\0 


Localtime and gmtime return pointers to structures containing the broken-down time. Localtime corrects 
for the time zone and possible daylight savings time; gmtime converts directly to GMT, which is the time 
UNIX uses. Asctime converts a broken-down time to ASCII and returns a pointer to a 26-character string. 


The structure declaration from the include file is: 


struct tm { /* see ctime(3) */ 


int tm_sec; 
int tm_min; 
int tm_hour; 
int tm_mday; 
int tm_mon; 
int tm_year; 
int tm_wday; 
int tm_yday; 
int tm_isdst; 


}s 
These quantities give the time on a 24-hour clock, day of month (1-31), month of year (0-11), year — 1900, 


day of week (Sunday = 0), day of year (0-365), and a flag that is 0 for standard time, nonzero for daylight 
saving or summer time. 


When local time is called for, the program consults the system to determine the time zone and whether the 
standard U.S.A. daylight saving time adjustment is appropriate. The program knows about the peculiarities 
of this conversion in 1974 and 1975; if necessary, a table for these years can be extended. 


Timezone returns the name of the time zone associated with its first argument, which is measured in min- 
utes westward from Greenwich. If the second argument is 0, the standard name is used, otherwise the Day- 
light Saving version. If the required name does not appear in a table built into the routine, the difference 
from GMT is produced; e.g. in Afghanistan timezone (—(60*4+30), 0) is appropriate because it is 4:30 
ahead of GMT and the string “GMT+4:30’ is produced. 


SEE ALSO 
time(2) 


BUGS 
The return values point to static data whose content is overwritten by each call. 
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NAME 
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isalpha, isupper, islower, isdigit, isalnum, isspace, ispunct, isprint, iscntrl, isascii — character classification 


SYNOPSIS 


#include 


<ctype.h> 


isalpha(c) 


isupper(c) 


islower(c) 


isdigit(c) 


isalnum( 


c) 


isspace(c) 


ispunct(c) 


isprint(c) 


iscntrl(c) 


isascii(c) 


DESCRIPTION 
These macros classify ASCII-coded integer values by table lookup. Each is a predicate returning nonzero 
for true, zero for false. Zsascii is defined on all integer values; the rest are defined only where isascii is true 


and on th 
isalpha 
isupper 
islower 
isdigit 
isalnum 
isspace 
ispunct 
isprint 
iscntrl 


isascil 


SEE ALSO 
tolower(3), ascii(7) 
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e single non-ASCII value EOF (see stdio(3)). 

cis a letter 

c is an upper case letter 

c is a lower case letter 

cis a digit 

c is an alphanumeric character 

c is a space, tab, carriage return, newline, or formfeed 

c is a punctuation character (neither control nor alphanumeric) 

c is a printing character, code 040 octal (space) through 0176 (tilde) 

c is a delete character (0177) or ordinary control character (less than 040). 


cis an ASCII character, i.e. OSc<0200. 
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NAME 
curses — screen functions with ‘optimal’ cursor motion 


SYNOPSIS 
cc args —Icurses —Itermcap 


DESCRIPTION 
These routines give the user a method of updating screens with reasonable optimization. They keep an 
image of the current screen, and the user sets up an image of a new one. Then refresh() tells the routines to 
make the current screen look like the new one. The initialization routine initscr() must be called before any 
other routines that deal with windows and screens. The routine endwin() should be called before exiting. 


SEE ALSO 
Ken Arnold, ‘Screen Updating and Cursor Movement Optimization: A Library Package, UNIX 
Programmer’s Manual, Berkeley 4.1BSD 


ioctl(2), termcap(5) 


FUNCTIONS 
addch(ch) 
addstr(str) 
box(win,vert,hor) 
crmode() 
clear() 
clearok(scr,boolf) 
clrtobot() 
clrtoeol() 
delwin(win) 
echo() 
endwin() 
erase() 
getch() 
getstr(str) 
gettmode() 
getyx(win,y,x) 
inch() 
initscr() 
leaveok(win,boolf) 
longname(termbuf,name) 
move(y,x) 
mvcur(lasty,lastx,newy,newx) 
newwin(lines,cols,begin_y,begin_x) 
nl() 
nocrmode() 
noecho() 
nonl() 
noraw() 
overlay(winl,win2) 
overwrite(winl,win2) 
printw(fmt,arg1,arg2.,...) 
raw() 
refresh() 
resetty() 
savetty() 
scanw(fmt,arg1,arg2.,...) 
scroll(win) 
scrollok(win,boolf) 
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add a character to stdscr 

add a string to stdscr 

draw a box around a window 
set cbreak mode 

clear stdscr 

set clear flag for scr 

clear to bottom on stdscr 
clear to end of line on stdscr 
delete win 

set echo mode 

end window modes 

erase stdscr 

get a char through stdscr 

get a string through stdscr 
get tty modes 

get (y,x) co-ordinates 

get char at current (y,x) co-ordinates 
initialize screens 

set leave flag for win 

get long name from termbuf 
move to (y,x) on stdscr 
actually move cursor 

create anew window 

set newline mapping 

unset cbreak mode 

unset echo mode 

unset newline mapping 
unset raw mode 

overlay winl on win2 
overwrite winl on top of win2 
printf on stdscr 

set raw mode 

make current screen look like stdscr 
reset tty flags to stored value 
stored current tty flags 

scanf through stdscr 

scroll win one line 

set scroll flag 
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setterm(name) 

standend() 

standout() 
subwin(win,lines,cols,begin_y,begin x) 
touchwin(win) 

unctrl(ch) 

waddch(win,ch) 
waddstr(win,str) 

wclear(win) 

welrtobot(win) 

wclrtoeol(win) 

werase(win) 

wegetch(win) 

weetstr(win,str) 

winch(win) 

wmove(win,y,x) 
wprintw(win,fmt,arg | ,arg2.,...) 
wrefresh(win) 
wscanw(win,fmt,arg | ,arg2,...) 
wstandend(win) 
wstandout(win) 
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set term variables for name 
end standout mode 

start standout mode 

create a subwindow 
‘change’ all of win 
printable version of ch 

add char to win 

add string to win 

clear win 

clear to bottom of win 
clear to end of line on win 
erase win 

get a char through win 

get a string through win 
get char at current (y,x) in win 
set current (y,x) co-ordinates on win 
printf on win 

make screen look like win 
scanf through win 

end standout mode on win 
start standout mode on win 
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NAME 
DBopen, DBclose, DBget, DBput, DBdel, DBkeyO, DBkeyn, DBlock, DBunlock, DBsync, DBapp, DBins, 
DBcopy — database subroutines 


SYNOPSIS 
#include <DB.h> 


typedef struct { 
char * dptr; 
int dsize; 

} datum; 

int DBdebug; 


DBFILE « DBopen(file, flags) 
char * file; 

int flags; 

datum DBget(dp, key) 
DBFILE «* dp; 

datum key; 


int DBput(dp, key, content) 
DBFILE * dp; 

datum key, content; 

int DBdel(dp, key) 
DBFILE * dp; 

datum key; 

datum DBkey0(dp) 
DBFILE * dp; 

datum DBkeyn(dp, key) 
DBFILE * dp; 

datum key; 

void DBclose(dp) 

DBFILE * dp; 

int DBlock(dp) 

DBFILE * dp; 

int DBunlock(dp) 

DBFILE * dp; 

void DBsync(dp) 

DBFILE * dp; 

int DBapp(dp, key, content) 


DBFILE * dp; 
datum key, content; 


int DBins(dp, key, content) 
DBFILE * dp; 
datum key, content; 


int DBcopy(sdp, ddp) 
DBFILE * sdp, ddp; 


DESCRIPTION 
These functions maintain key/content pairs in a data base. The functions will handle databases as large as 
the filesystem can handle and will access a keyed item in one or two file system accesses. The functions are 
obtained with the loader option -IDB. 
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Keys and contents are described by the datum typedef. A datum specifies a string of dsize bytes pointed to 
by dptr. Arbitrary binary data, as well as normal ASCII strings, are allowed as either keys or records. The 
data base is stored in two files. One file is a directory containing a bit map and has ‘.dir’ as its suffix. The 
second file contains all data and has ‘.pag’ as its suffix. 


Before a database can be accessed, it must be opened by DBopen. At the time of this call, the files file.dir 
and file pag must exist unless the DB_CREATE flag is set in the flags argument. If this flag is specified and 
the files exist, they are truncated. The only other meaningful flag that may be specified is DB_RONLY, 
which indicates that the DB library may not write on the files. If the files are both not writable, this flag 
need not be specified and the d_flags member of the returned DBFILE pointer will have this bit set. Note 
that these flags are mutually exclusive, and if one must be ignored, it will be DB_RONLY. 


Once open, the data stored under a key is accessed by DBget and data is placed under a key or overwritten 
by DBput. The data denoted by a key may be appended to, or inserted before, by DBapp and DBins, 
respectively. A key (and its associated contents) is deleted by DBdel. A linear pass through all keys in a 
database may be made, in an (apparently) random order, by use of DBkeyO and DBkeyn. DBkey0O will 
return the first key in the database. With any key argument, DBkeyn will return the next key in the data- 
base. This code will traverse the data base: 


for (key = DBkeyO(dp); key.dptr != NULL; key = DBkeyn(dp, key)) 
DBcopy copies the data indicated by keys in the database referred to by its first argument to the database 


indicated by its second argument using the same traversal. 


DBlock and DBunlock set and clear advisory locks (see ioctl(4)) on the database files. DBlock returns when 
the lock is set by the invoking process. 


DBsync flushes any modified buffers, and is called by DBunlock and DBclose. 


DIAGNOSTICS 
All functions that return an int indicate errors with negative values. A zero return indicates success. Rou- 
tines that return a datum indicate errors with a null (0) dptr. 


DBput will return an error in the event that a disk block fills with inseparable data. 


Debugging information will be printed out on stderr if DBdebug is set to one of DBDBCORE, DBDBERR, 
DBDBWARN, or DBDBINFO. These values provide increasing amounts of information, ranging from con- 
ditions that will cause abnormal termination of the program to call traces of the user-accessible routines 


BUGS 
The ‘.pag’ file will contain holes so that its apparent size is about four times its actual content. Older UNIX 
systems may create real file blocks for these holes when touched. These files cannot be copied by normal 
means cat(1), tp(1), tar(1), ar(1)) without filling in the holes. A command to permit copying of these files 
(with holes intact) is provided 


Dptr pointers returned by these subroutines point into static storage that is changed by subsequent calls. 


The sum of the sizes of a key/content pair must not exceed the internal block size (currently 65536 (64K) 
bytes). Moreover, all key/content pairs that hash together must fit on a single block. 


DBdel does not physically reclaim file space, although it does make it available for reuse. Use DBcp(1) or 
DBcopy if file space must be reclaimed. 


The order of keys presented by DBkeyO and DBkeyn depends on a hashing function, not on anything inter- 
esting. 


Since these routines use binary data for internal housekeeping, databases created on a VAX cannot be 
directly manipulated on a 3B, and vice versa. DBcvt(1) converts a database generated on either of these 
machines to a form palatable on the other. 


SEE ALSO 
DB(1), DBcp(1), DBcvt(1). 
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NAME 


dbminit, fetch, store, delete, firstkey, nextkey — database subroutines 


SYNOPSIS 


typedef struct { 
char *dptr; 
int dsize; 

} datum; 

dbminit(file) 

char *file; 

datum fetch(key) 

datum key; 

store(Key, value) 

datum key, value; 


delete(key) 
datum key; 


datum firstkey() 


datum nextkey(key) 
datum key; 


DESCRIPTION 


These functions maintain key/value pairs in a data base. The functions will handle very large databases in 
one or two file system accesses per key. The functions are loaded with /d(1) option -Idbm. 


Keys and values are described by the datum typedef. A datum specifies a string of dsize bytes pointed to by 
dptr. Arbitrary binary data, as well as normal ASCII strings, are allowed. The data base is stored in two 
files. One file is a directory containing a bit map and has ‘dir’ as its suffix. The second file contains all 
data and has ‘.pag’ as its suffix. 


Before a database can be accessed, it must be opened by dbminit. At the time of this call, the files file.dir 
and file.pag must exist. (An empty database is created by creating zero-length ‘.dir’ and ‘.pag’ files.) 

Once open, the data stored under a key is accessed by fetch and data is placed under a key by store. A key 
and its associated value are deleted by delete. A linear pass through all keys in a database may be made, in 
random order, by use of firstkey and nextkey. Firstkey will return the first key in the database. With any 
key nextkey will return the next key in the database. This code will traverse the data base: 


for(key = firstkey(); key.dptr != NULL; key = nextkey(key)) 


DIAGNOSTICS 


All functions that return an int indicate errors with negative values. A zero return indicates success. Rou- 
tines that return a datum indicate errors with a null (0) dptr. 


SEE ALSO 


BUGS 


Page | 


cbt(3) 


The ‘.pag’ file will contain holes so that its apparent size is about four times its actual content. These files 
cannot be copied by normal means (cp, cat, tp, tar, ar) without filling in the holes. 

Dptr pointers returned by these subroutines point into static storage that is changed by subsequent calls. 
The sum of the sizes of a key/value pair must not exceed a fixed internal block size. Moreover all 
key/value pairs that hash together must fit on a single block. Store will return an error in the event that a 
disk block fills with inseparable data. 

Delete does not physically reclaim file space, although it does make it available for reuse. 
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NAME 


dialout — place call on ACU 


SYNOPSIS 


dialout(class, telno) 
char *class, *telno; 


DESCRIPTION 


FILES 


Dialout searches for an automatic calling unit of the appropriate service class and places a data call on the 
associated line, using the given telephone number. If successful, it returns an open file descriptor for the 
line. The file is in raw mode, and has exclusive-use and hangup-on-close modes set. It returns —1 if all 
ACUs of the given class are busy, —3 if carrier could not be set, and —9 if the service class is unidentifiable. 


The routine consults a data file /etc/aculist that consists of lines containing six blank- or tab-separated 
fields. 


service class 
Each line with a service class matching the one specified is tried in turn until an unoccupied one is 
found. Service classes may be used used to specify a switching system (e.g. Dimension or Centrex) 
and speed rate. 


file The file name of the associated special file for the telephone line. 


acu‘ The file name of the associated ACU. If specified as none, no ACU is used and the telephone num- 
ber is ignored. This is for hardwired connections. 


speed The bit rate of the interface, chosen from the numbers given in ttyld(4). 


prefix A string to be prefixed to the number. This is handy for shared ACUs in which the first digit 
specifies a line. The prefix — is taken to be an empty prefix. 


postfix 
A string to be postfixed to the number to be dialled. Some ACUs require an ‘end of number’ code; 
it should be specified here. 


/etc/aculist 


SEE ALSO 
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ttyld(4), dn(4), cu(1) 
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NAME 


opendir, readdir, telldir, seekdir, closedir — directory operations 


SYNOPSIS 


#include <sys/types.h> 
#include <ndir.h> 


DIR *opendir(filename) 
char *filename; 


struct direct *readdir(dirp) 
DIR *dirp; 

long telldir(dirp) 

DIR *dirp; 

seekdir(dirp, loc) 

DIR *dirp; 

long loc; 

closedir(dirp) 

DIR *dirp; 


DESCRIPTION 


Opendir opens the directory named by filename and associates a “directory stream’ with it. Opendir returns 
a pointer to be used to identify the directory stream in subsequent operations. The pointer value 0 is 
returned if filename cananot be accessed or is not a directory. 


Readdir returns a pointer to the next directory entry. It returns 0 upon reaching the end of the directory or 
detecting an invalid seekdir operation. 


Telldir returns the current location associated with the named directory stream. 


Seekdir sets the position of the next readdir operation on the directory stream. The new position reverts to 
the one associated with the directory stream when the felldir operation was performed. Values returned by 
telldir are good only for the lifetime of the DIR pointer from which they are derived. 


Closedir causes the named directory stream to be closed, and the structure associated with the DIR pointer 
to be freed. 


The preferred way to search the current directory is: 
len = strlen(name); 
dirp = opendir("."); 
for (dp = readdir(dirp); dp != NULL; dp = readdir(dir)) 
if (dp—>d_namlen == len && !stremp(dp—>d_name, name)) { 
closedir(dirp); 
return FOUND; 
} 
closedir(dirp); 
return NOT_FOUND; 


SEE ALSO 


Page | 


dir(5), open(2), close(2), read(2), lseek(2) 


DKMGR (3X) Eighth Edition DKMGR (3X) 


NAME 


dkmegr, dkmgrack, dkmgrnak, dkfilename — establish datakit server 


SYNOPSIS 


#include <dkmgr.h> 


struct mgrmsg * 
dkmgr(srvname, traffic) 
char *srvname; 


char * 
dkfilename(chan) 


dkmgrack(chan) 


dkmgrnak(chan, error) 


DESCRIPTION 


FILES 


These routines are loaded by option —Idk of /d(1). 


Dkmgr sets up the calling process as a datakit server, and waits for service requests. It returns a pointer to 
an incoming service request in the form: 


struct mgrmsg { 
short m_chan; 
short m_tstamp; 
short m_ traffic; 
char *m_dial; 
char *m_ service; 
char *m_ source; 
char *m_uid; 
char *m_param1; 
char *m_param?2; 
}s 
Field m_chan gives the channel number of the incoming request. The circuit is already established, and this 
channel need only be opened. The appropriate special file name is returned as a static string by dkfilename. 
Field m_uid is generated by the caller (see tdkdial(3)), if the request originated in a standard UNIX system, 
and is the userid of the requester. It can be trusted if, and only if, you trust the administrators and super- 
users on the calling system. Field m_param1 and m_param2 are the first and subsequent strings after the 
destination name in the dialstring. They can be used to pass short pieces of information from the requester 
to the server about how to handle the call. 


Traffic tells the network what types of requests this server is capable of handling. Value 0 indicates 
terminal-like traffic only, value 2 allows either terminal or high-speed host-host traffic. The field m_traffic 
of the incoming call message tells the traffic requested by the caller. 


The string m_dial gives the dialing string used by the calling process, and m_source is the name of the port 
in the network where the call originated. 


The server program is expected to call either dkmgrack or dkmgrnak to complete the call setup. The first 
acknowledges and accepts the call, the second rejects the call with a specific error code giving the reason. 


/dev/dk directory containing files naming each channel. 


SEE ALSO 


tdkdial(3) 


DIAGNOSTICS 
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In case of a major setup error, a message is printed on the standard error file and the process exits. For 
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minor errors, a message is printed and the process tries again after a wait interval. 


BUGS 
It always waits for connection requests; there should be a version that accepts them asynchronously. 
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NAME 
ecvt, fcvt, gcvt — output conversion 


SYNOPSIS 
char *ecvt(value, ndigit, decpt, sign) 
double value; 
int ndigit, «decpt, «sign; 


char *fcvt(value, ndigit, decpt, sign) 
double value; 
int ndigit, «decpt, «sign; 


char *gcvt(value, ndigit, buf) 
double value; 
char «buf; 


DESCRIPTION 
Ecvt converts the value to a null-terminated string of ndigit ASCII digits and returns a pointer thereto. The 
position of the decimal point relative to the beginning of the string is stored indirectly through decpt (nega- 
tive means to the left of the returned digits). If the sign of the result is negative, the word pointed to by sign 
is non-zero, otherwise it is zero. The low-order digit is rounded. 


Fcvt is similar to ecvt and produces output for the Fortran format F*.ndigit. If decpt < —ndigit, then the 
returned string is null. Otherwise, decptt+ndigit characters are returned. 


Gcvt converts the value to a null-terminated ASCII string in buf and returns a pointer to buf. It attempts to 
produce ndigit significant digits in Fortran F format if possible, otherwise E format, ready for printing. 
Trailing zeros may be suppressed. 


SEE ALSO 
printf(3) 


BUGS 
The return values point to static data whose content is overwritten by each call. 
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NAME 
end, etext, edata — last locations in program 


SYNOPSIS 
extern end; 
extern etext; 
extern edata; 


DESCRIPTION 
These names refer neither to routines nor to locations with interesting contents. The address of etext is the 
first address above the program text, edata above the initialized data region, and end above the uninitialized 
data region. 


When execution begins, the program break coincides with end, but it is reset by the routines brk(2), 
malloc(3), standard input/output (stdio(3)), the profile (-p) option of cc(1), etc. The current value of the 
program break is reliably returned by ‘sbrk(0)’, see brk(2). 


SEE ALSO 
brk(2), malloc(3) 
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NAME 
erf, erfc — error function 


SYNOPSIS 
#include <math.h> 


double erf(x) 
double x; 


double erfc(x) 
double x; 


DESCRIPTION 
These functions calculate the error function erf(x) $="(2/ sqrt pi ) int from 0 to x roman exp (-t sup 2 ) dt$ 
and the complementary error function erfc(x) = 1 — erf(x). The error criterion for both erf and erfc is rela- 
tive. 


DIAGNOSTICS 
There are no error returns. 
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NAME 
exp, log, log10, pow, sqrt — exponential, logarithm, power, square root 


SYNOPSIS 
#include <math.h> 


double exp(x) 
double x; 


double log(x) 
double x; 


double log10(x) 
double x; 


double pow(x, y) 
double x, y; 


double sqrt(x) 
double x; 


DESCRIPTION 
Exp returns the exponential function of x. 


Log returns the natural logarithm of x; /og/0 returns the base 10 logarithm. 
Pow returns x. 
Sqrt returns the square root of x. 


SEE ALSO 
hypot(3), sinh(3), intro(2) 


DIAGNOSTICS 
Exp and pow return a huge value when the correct value would overflow; errno is set to ERANGE. Pow 
returns 0 and sets errno to EDOM when the second argument is negative and non-integral and when both 
arguments are 0. 


Log returns a huge negative value when x is zero or negative; errno is set to EDOM. 


Sqrt returns 0 when x is negative; errno is set to EDOM. 
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NAME 
fclose, fflush — close or flush a stream 


SYNOPSIS 
#include <stdio.h> 


fclose(stream) 
FILE *stream; 


fflush(stream) 
FILE *stream; 


DESCRIPTION 
Fclose causes any buffers for the named stream to be emptied, and the file to be closed. Buffers allocated 
by the standard input/output system are freed. 


Fclose is performed automatically upon calling exit(2). 


Fflush causes any buffered data for the named output stream to be written to that file. The stream remains 
open. 

SEE ALSO 
close(2), fopen(3), setbuf(3) 


DIAGNOSTICS 
These routines return EOF if stream is not associated with an output file, or if buffered data cannot be trans- 
ferred to that file. 
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NAME 
feof, ferror, clearerr, fileno — stream status inquiries 


SYNOPSIS 
#include <stdio.h> 


feof(stream) 
FILE «stream; 


ferror(stream) 
FILE *stream 


clearerr(stream) 
FILE «stream 


fileno(stream) 
FILE *stream; 


DESCRIPTION 
Feof returns non-zero if end of file has been encountered on the named input stream, otherwise zero. 


Ferror returns non-zero when an error has occurred reading or writing the named stream, otherwise zero. 
Unless cleared by clearerr, the error indication lasts until the stream is closed. 


Clearerr resets the error indication on the named stream. 
Fileno returns the integer file descriptor associated with the stream, see open(2). 
These functions are implemented as macros; they cannot be redeclared. 


SEE ALSO 
fopen(3), open(2) 
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NAME 
fabs, floor, ceil — absolute value, floor, ceiling functions 


SYNOPSIS 
#include <math.h> 


double floor(x) 
double x; 


double ceil(x) 
double x; 


double fabs(x) 
double x; 


DESCRIPTION 
Fabs returns the absolute value | x | : 


Floor returns the largest integer not greater than x. 
Ceil returns the smallest integer not less than x. 


SEE ALSO 
abs(3), frexp(3) for modf() 
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NAME 


fopen, freopen, fdopen — open a stream 


SYNOPSIS 


#include <stdio.h> 


FILE «fopen(filename, type) 
char «filename, «type; 


FILE «freopen(filename, type, stream) 
char «filename, «type; 
FILE *stream; 


FILE «fdopen(fildes, type) 
char «type; 


DESCRIPTION 


Fopen opens the file named by filename and associates a stream with it. Fopen returns a pointer to be used 
to identify the stream in subsequent operations. 


Type is a character string having one of the following values: 


woe 


rt open for reading 


Woon 


w" create for writing 


wo 


a" append: open for writing at end of file, or create for writing 


Freopen substitutes the named file in place of the open stream. It returns the original value of stream. The 
original stream is closed. Freopen is typically used to attach the preopened constant names, ‘stdin’, “std- 
out’, ‘stderr’, to specified files. 


Fdopen associates a stream with a file descriptor obtained from open, dup, creat, or pipe(2). The type of 
the stream must agree with the mode of the open file. 


SEE ALSO 


open(2), fclose(3) 


DIAGNOSTICS 


BUGS 
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Fopen and freopen return the pointer NULL if filename cannot be accessed. 


Fdopen is not portable to systems other than UNIX. 
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NAME 
fread, fwrite — buffered binary input/output 


SYNOPSIS 
#include <stdio.h> 


fread(ptr, sizeof(«ptr), nitems, stream) 
FILE *stream; 


fwrite(ptr, sizeof(«ptr), nitems, stream) 
FILE *stream; 


DESCRIPTION 
Fread reads, into a block beginning at ptr, nitems of data of the type of *ptr from the named input stream. 
It returns the number of items actually read. 


Fwrite appends at most nitems of data of the type of *ptr beginning at ptr to the named output stream. It 
returns the number of items actually written. 


SEE ALSO 
read(2), write(2), fopen(3), getc(3), putc(3), gets(3), puts(3), printf(3), scanf(3) 


DIAGNOSTICS 
Fread and fwrite return 0 upon end of file or error. 


Page | 


FREXP (3 ) Eighth Edition FREXP(3) 


NAME 
frexp, ldexp, modf — split into mantissa and exponent 


SYNOPSIS 
double frexp(value, eptr) 
double value; 
int *eptr; 


double Idexp(value, exp) 
double value; 


double modf(value, iptr) 
double value, *iptr; 


DESCRIPTION 
Frexp returns the mantissa of value and stores the exponent indirectly through eptr, so that value = 
frexp (value )*2**(*eptr). 


Ldexp returns the quantity value *2**exp. 


Modf returns the positive fractional part of value and stores the integer part indirectly through iptr. 
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NAME 


fseek, ftell, rewind — reposition a stream 


SYNOPSIS 


#include <stdio.h> 


fseek(stream, offset, ptrname) 
FILE *stream; 
long offset; 


long ftell(stream) 
FILE *stream; 


rewind(stream) 


DESCRIPTION 


F seek sets the position of the next input or output operation on the stream. The new position is at the 
signed distance offset bytes from the beginning, the current position, or the end of the file, according as 
ptrname has the value 0, 1, or 2. 


F seek undoes any effects of ungetc(3). 


Ftell returns the current value of the offset relative to the beginning of the file associated with the named 
stream. It is measured in bytes on UNIX; on some other systems it is a magic cookie, and the only fool- 
proof way to obtain an offset for fseek. 


Rewind(stream) is equivalent to fseek(stream, OL, 0). 


SEE ALSO 


Iseek(2), fopen(3) 


DIAGNOSTICS 
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F seek returns —1 for improper seeks. 


FTW (3) 


NAME 


Eighth Edition FTW(3) 


ftw — file tree walk 


SYNOPSIS 


#include <ftw.h> 


int ftw(path, fn, depth) 
char «path; 

int (*fn) (); 

int depth; 

#include <sys/types.h> 


#include <sys/stat.h> 
fn(name, statb, code) char *name; struct stat statb; 


DESCRIPTION 


BUGS 
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Ftw recursively descends the directory hierarchy rooted in path. For each object in the hierarchy, ftw calls 
Jn, passing it a pointer to a null-terminated character string containing the name of the object, a pointer to a 
stat structure (see stat(2)) containing information about the object, and an integer. Possible values of the 
integer, defined in <ftw.h>, are FTW _F for a file, FTW_D for a directory, FTW DNR for a directory that 
cannot be read, and FTW_NS for an object on which stat failed. If the integer is FTW_DNR, descendents 
of that directory will not be processed. If the integer is FTW_NS, the stat structure will contain garbage. 


F tw visits a directory before visiting any of its descendents. 


The tree traversal continues until the tree is exhausted, an invocation of fn returns a nonzero value, or some 
error is detected within ftw (such as an I/O error). If the tree is exhausted, ftw returns zero. If fn returns a 
nonzero value, ftw stops its tree traversal and returns whatever value was returned by jn. If ftw detects an 
error, it returns —1, and indicates the error type in errno. 


Ftw uses one file descriptor for each level in the tree. The depth argument limits the number of file descrip- 
tors so used. If depth is zero or negative, the effect is the same as if it were 1. Depth must not be greater 
than the number of file descriptors currently available for use. Ftw will run more quickly if depth is at least 
as large as the number of levels in the tree. 


Ftw doesn’t recognize symbolic links, which can cause infinite recursion. 


GALLOC (3) Eighth Edition GALLOC(3) 


NAME 


galloc, gfree, garbage — storage allocation with garbage collection 


SYNOPSIS 


char *galloc(n) 
unsigned n; 


gfree(p) 
char *p; 


garbage( ) 


DESCRIPTION 


These functions perform heap storage allocation with garbage collection. 


Galloc allocates a block of at least n bytes and returns a pointer to it. Gfree frees a block previously allo- 
cated by galloc. 


When space gets tight, garbage blocks are freed automatically. A block allocated by galloc is deemed to be 
garbage unless it is reachable. A reachable block is one whose first byte is pointed to by a declared C vari- 
able or by a pointer in a reachable block. 


The frequency of garbage collection is controlled by external variables declared 
long gemax = 5000, gemin = 50; 


No more than gcmax allocations may intervene between automatic collections; this feature will help contain 
the growth of virtual address space. At least gcmin allocations must intervene, otherwise garbage collection 
will be abandoned as fruitless. Garbage may be called to do garbage collection at an arbitrary time. 


Malloc(3) and galloc allocate from the same arena, but garbage collection affects only galloc blocks. Free 
(see malloc(3)) must not be used on blocks allocated with galloc. 


DIAGNOSTICS 


Galloc returns a null (0) pointer when space cannot be found. 


SEE ALSO 


BUGS 


Page | 


malloc(3) 


Garbage collection is conservative; blocks that appear to be pointed to from within declared storage will not 
be freed, regardless of whether the apparent ‘pointers’ were declared as such. 


GAMMA (3M ) Eighth Edition GAMMA(3M) 


NAME 
gamma — log gamma function 


SYNOPSIS 
#include <math.h> 


double gamma(x) 
double x; 
DESCRIPTION 


Gamma returns In T(x ). The sign of I(x ) is returned in the external integer signgam. The following C 
program might be used to calculate I: 


y = gamma(x); 
if (y > 88.0) 
error(); 
y = signgam*exp(y); 
DIAGNOSTICS 
A huge value is returned for negative integer arguments. 


BUGS 
There should be a positive indication of error. 
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NAME 
getarg, iargc — command arguments to Fortran 


SYNOPSIS 
subroutine getarg(argno, string) 
integer argno 
character *(*) string 
iargce() 
DESCRIPTION 
These procedures permit Fortran programs to access the command arguments. The integer function iargc 
returns the number of command arguments. The subroutine gefarg stores the argnoth command argument 


in its second argument. The string is truncated or padded with blanks, in accord with the rules of Fortran 
character assignment. 


The command 
a.out arg] argument2 
provides 2 as the value of iargc. If s is declared character*4, then 
call getarg(2, s) 
will put ‘argl’ ins. 
SEE ALSO 
exec(2) 
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NAME 


getc, getchar, fgetc, getw — get character or word from stream 


SYNOPSIS 


#include <stdio.h> 


int getc(stream) 
FILE *stream; 


int getchar() 


int fgetc(stream) 
FILE *stream; 


int getw(stream) 
FILE *stream; 


DESCRIPTION 


Getc returns the next character from the named input stream. 
Getchar() is identical to getc(stdin). 
Fgetc behaves like getc, but is a genuine function, not a macro; it may be used to save object text. 


Getw returns the next word (32-bit integer on a VAX) from the named input stream. It returns the constant 
EOF upon end of file or error, but since that is a good integer value, feof and ferror(3) should be used to 
check the success of getw. Getw assumes no special alignment in the file. 


SEE ALSO 


fopen(3), putc(3), gets(3), scanf(3), fread(3), ungetc(3) 


DIAGNOSTICS 


BUGS 
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These functions return the integer constant EOF at end of file or upon read error. 


Because it is implemented as a macro, gefc treats a stream argument with side effects incorrectly. In partic- 
ular, ‘getc(*f++)’ doesn’t work sensibly. 
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NAME 

getenv — value for environment name 
SYNOPSIS 

char *getenv(name) 

char *name; 
DESCRIPTION 


Getenv searches the environment list (see environ(5)) for a string of the form name=value and returns value 
if such a string is present, otherwise 0 (NULL). 


SEE ALSO 
environ(5), exec(2) 
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NAME 


getfsent, getfsspec, getfsfile, setfsent, endfsent — get file system descriptor file entry 


SYNOPSIS 


#include <fstab.h> 
struct fstab «getfsent() 


struct fstab «getfsspec(name) 
char *name; 


struct fstab «getfsfile(name) 
char *name; 


int setfsent() 


int endfsent() 


DESCRIPTION 


FILES 


Getfsent, getfsspec and getfsfile each return a pointer to an object with the following structure containing 
the broken-out fields of a line in the file system description file, fstab (5). 


#define FSNMLG 16 


struct fstab { 
char fs_spec[FSNMLG]; 
char fs_file[FSNMLG]; 
char fs_type[3]; 
int fs_freq; 
int fs_passno; 
}s 
The fields have meanings described in fstab(5). 
Getfsent reads the next line of the file, opening the file if necessary. 
Setfsent opens and rewinds the file. 
Endfsent closes the file. 


Getfsspec and getfsfile sequentially search from the beginning of the file until a matching special file name 
or file system file name is found, or until EOF is encountered. 


/etc/fstab 


SEE ALSO 


fstab(5) 


DIAGNOSTICS 


BUGS 
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Null pointer (0) returned on EOF or error. 


All information is contained in a static area so it must be copied if it is to be saved. 
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NAME 


getgrent, getgrgid, getgrnam, setgrent, endgrent — get group file entry 


SYNOPSIS 


#include <grp.h> 

struct group *getgrent(); 

struct group *getgrgid(gid) 

struct group *getgrnam(name) char *name; 
setgrent(); 

endgrent(); 


DESCRIPTION 


FILES 


Getgrent, getgrgid and getgrnam each return pointers to an object with the following structure containing 
the broken-out fields of a line in the group file. 


struct group { /* see getgrent(3) */ 


char *or name; 
char *or passwd; 
int gr_ gid; 

char **or mem; 


}; 
The members of this structure are: 


gr name 
The name of the group. 

gr_ passwd 
The encrypted password of the group. 

gr gid The numerical group-ID. 

gr mem 
Null-terminated vector of pointers to the individual member names. 


Getgrent simply reads the next line while getgrgid and getgrnam search until a matching gid or name is 
found (or until EOF is encountered). Each routine picks up where the others leave off so successive calls 
may be used to search the entire file. 


A call to setgrent has the effect of rewinding the group file to allow repeated searches. Endgrent may be 
called to close the group file when processing is complete. 


/etc/group 


SEE ALSO 


getlogin(3), getpwent(3), group(5) 


DIAGNOSTICS 


BUGS 
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A null pointer (0) is returned on EOF or error. 


All information is contained in a static area so it must be copied if it is to be saved. 
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NAME 
getlogin — get login name 

SYNOPSIS 
char *getlogin() 

DESCRIPTION 
Getlogin returns a pointer to the login name as found in /etc/utmp. It may be used in conjunction with 
getpwnam to locate the correct password file entry when the same userid is shared by several login names. 
If getlogin is called within a process that is not attached to a typewriter, it returns NULL. The correct pro- 
cedure for determining the login name is to first call getlogin and if it fails, to call getpwuid. 

FILES 
/etc/utmp 

SEE ALSO 
getpwent(3), getgrent(3), utmp(5), getuid(2) 

DIAGNOSTICS 
Returns NULL (0) if name not found. 

BUGS 


The return values point to static data whose content is overwritten by each call. 
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NAME 
getopt — get option letter from argv 


SYNOPSIS 
int getopt (argc, argv, optstring) 
int argc; 
char **argy; 
char *optstring; 
extern char *optarg; 
extern int optind; 


DESCRIPTION 
Getopt returns the next option letter in argv that matches a letter in optstring. Optstring is a string of rec- 
ognized option letters; if a letter is followed by a colon, the option is expected to have an argument which 
may or may not be separated from it by white space. Optarg is set to point to the start of the option argu- 
ment on return from geftopt. 


Getopt places in optind the argv index of the next argument to be processed. Since optind is external, it is 
normally initialized to zero automatically before the first call to getopt. 


Option letters appear in nonempty clusters preceded by ‘—’. When all options have been processed (i.e., up 
to the first non-option argument), gefopt returns EOF. The special option ‘—’ may be used to delimit the 
end of the options; EOF will be returned, and ‘—’ will be skipped. 


DIAGNOSTICS 
Getopt prints an error message on stderr and returns a question mark (“?*) when it encounters an option let- 
ter not included in optstring. 


EXAMPLE 
This fragment processes arguments for a command that can take option a and option f, which requires an 
argument. 


main (argc, argv) char **argv; 
{ 
int c; 
extern int optind; 
extern char **optarg, **ifile; 
while ((c = getopt (argc, argv, "af:")) !=—1) 
switch (c) { 
case ‘a’: aflg++; 
break; 
case “f*: ifile = optarg; 
break; 
case “?*: errflg++; 
} 
if (errflg) { 
fprintf (stderr, "usage: . . ."); 
exit (2); 
} 
for( ; optind < argc; optind++) { 
if (access (argv[optind], 4)) { 
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NAME 
getpass — read a password 


SYNOPSIS 
char *getpass(prompt) 
char *prompt; 

DESCRIPTION 
Getpass reads a password from the file /dev/tty, or if that cannot be opened, from the standard input, after 
prompting with the null-terminated string prompt and disabling echoing. A pointer is returned to a null- 
terminated string of at most 8 characters. 


FILES 
/dev/tty 
SEE ALSO 
crypt(3) 
BUGS 


The return value points to static data whose content is overwritten by each call. 
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NAME 


getpw, getpwent, getpwuid, getpwnam, setpwent, endpwent, pwdecode — get password file entry 


SYNOPSIS 


getpw(uid, buf) 
char «buf; 


#include <pwd.h> 

struct passwd *getpwent() 

struct passwd *getpwuid(uid) int uid; 

struct passwd *getpwnam(name) char *name; 
int setpwent() 

int endpwent() 


struct passwd *pwdecode(p) char *p; 


DESCRIPTION 


FILES 


Getpw searches the password file for the (numerical) uid and fills in buf with a corresponding line. The line 
is null-terminated. 


Getpwent, getpwuid and getpwnam each return a pointer to an object with the following structure contain- 
ing the broken-out fields of a line in the password file. 


struct passwd { /* see getpwent(3) */ 
char *pWw_name; 
char *pWw_passwd; 
int pw_uid; 
int pw_ gid; 
int pw_quota; 
char *pw_comment; 
char *DW_ZeCOS; 
char *pw_ dir; 
char *pw_ shell; 
}; 
The fields pw_quota and pw_comment are unused; the others have meanings described in passwd (5). 
Getpwent reads the next line (opening the file if necessary); setpwent rewinds the file; endpwent closes it. 


Getpwuid and getpwnam search from the beginning until a matching uid or name is found (or until EOF is 
encountered). 


Pwdecode breaks out a null-terminated character string p containing a password file entry. The input string 
is modified by the call and the output structure contains pointers into it. 


/etc/passwd 


SEE ALSO 


getlogin(3), getgrent(3), passwd(5) 


DIAGNOSTICS 


BUGS 
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Getpw returns nonzero for error; other routines return 0 for end of file or error. 


All information is contained in a static area so it must be copied if it is to be saved. 
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NAME 
gets, fgets — get a string from a stream 


SYNOPSIS 
#include <stdio.h> 
char *gets(s) 
char *s; 
char *fgets(s, n, stream) 
char *s; 
FILE «stream; 
DESCRIPTION 
Gets reads a string into s from the standard input stream ‘stdin’. The string is terminated by a newline char- 
acter, which is replaced in s by a null character. Gets returns its argument. 


Fgets reads n—1 characters, or up to a newline character, whichever comes first, from the stream into the 
string s. The last character read into s is followed by a null character. Fgets returns its first argument. 
SEE ALSO 
puts(3), getc(3), scanf(3), fread(3), ferror(3) 
DIAGNOSTICS 
Gets and fgets return the constant pointer NULL upon end of file or error. 


BUGS 
Gets deletes a newline, fgets keeps it, all in the name of backward compatibility. 
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NAME 
getwd, getcwd — get current directory 


SYNOPSIS 
char *getwd(buf) 
char «buf; 


char *getcwd (buf, size) 
char «buf; 


DESCRIPTION 
Both routines fill buf with a null-terminated string representing the current directory and return buf. A null 
pointer is returned on an error and buf is filled with a diagnostic. 


Getwd is in the style of 4.2 BSD and getcwd in that of System V. If buf is null, this entry will call 
malloc (3) to allocate size bytes for the buffer. 


SEE ALSO 
pwd(1) 
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NAME 
hypot, cabs — euclidean distance 


SYNOPSIS 
#include <math.h> 


double hypot(x, y) 
double x, y; 


double cabs(z) 
struct { double x, y; } 


DESCRIPTION 
Hypot and cabs return 


taking precautions against unwarranted overflows. 


SEE ALSO 
exp(3) for sqrt 
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NAME 


in_host, in_ntoa, in_address, in_service - internet operations 


SYNOPSIS 


#include <sys/inet/in.h> 


char *in_host(hostaddr) 
in_addr hostaddr; 


char *in_ntoa(hostaddr) 
in_addr hostaddr; 


in_addr in_address(hostname) 
char *hostname; 


struct in_service *in_service(name, proto, port) 
char “name, «proto; 
unsigned int port; 


DESCRIPTION 


FILES 


These routines are loaded by the -lin option of /d(1). 


Internet addresses, type in_addr, are 32 bit quantities global to the network. The ascii representation for an 
in_addr can be either a host name or the form b/1.b2.b3.b4, where each ‘bx’ is the value of the x’th byte of 
the address in decimal. The mapping of an internet address to a host name is an n to m mapping. Since 
host names are considered local ‘aliases’ for internet addresses, the host to address mapping is subjective. 


In_address maps an internet host name to an address. 
In_host maps an internet address into a host name. 
In_ntoa maps an internet address to its ascii numeric format. 


In_service looks up an entry in the services file and returns the closest match. If either name or port are 0, 
they will match any name or port. If proto is 0, the ‘‘tcp’’ protocol is assumed. 


/usr/inet/lib/hosts mapping between host names and addresses 
/usr/inet/lib/networks mapping between network names and addresses 
/usr/inet/lib/services database of services 

/usr/inet/lib/hosts.equiv machines with common administration 


SEE ALSO 


BUGS 
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tep(3), udp(3) 


The mappings between internet addresses and names is arbitrary at best. The hosts file may contain many 
addresses for each name and/or many names for each address. In_address and in_host each start at the 
beginning of the file and search sequentially for a match. Therefore, in_addr(in_host(addr)) == addr is 
not necessarily true. 


JO(3M) Eighth Edition JO(3M) 


NAME 

jO, jl, jn, yO, yl, yn — bessel functions 
SYNOPSIS 

#include <math.h> 


double j0(x) 
double x; 
double j1(x) 
double x; 
double jn(n, x) 
double x; 


double y0(x) 
double x; 


double y1(x) 
double x; 
double yn(m, x) 
double x; 


DESCRIPTION 
These functions calculate Bessel functions of the first and second kinds for real arguments and integer 
orders. 


DIAGNOSTICS 
Negative arguments cause y0, y/, and yn to return a huge negative value and set errno to EDOM. 
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NAME 
13tol, ltol3 — convert between 3-byte integers and long integers 


SYNOPSIS 
13tol(Ip, cp, n) 
long *Ip; 
char «cp; 
Itol3(cp, Ip, n) 
char «cp; 
long *lp; 
DESCRIPTION 
L3tol converts a list of n three-byte integers packed into a character string pointed to by cp into a list of 
long integers pointed to by Ip. 


Ltol3 performs the reverse conversion from long integers (/p) to three-byte integers (cp). 
These functions are useful for file-system maintenance where the i-numbers are three bytes long. 


SEE ALSO 
filsys(5) 
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NAME 


malloc, free, realloc, ialloc, calloc, cfree —- main memory allocator 


SYNOPSIS 


char *malloc(size) 
unsigned size; 


free(ptr) 
char «ptr; 


char *realloc(ptr, size) 
char «ptr; 

unsigned size; 
ialloc(ptr, size) 

char «ptr; 

unsigned size; 


char *calloc(nelem, elsize) 
unsigned nelem, elsize; 


cfree(ptr) 
char «ptr; 


DESCRIPTION 


Malloc and free provide a simple general-purpose memory allocation package. Malloc returns a pointer to 
a new block of at least size bytes. 


The argument to free is a pointer to a block previously allocated by malloc; this space is made available for 
further allocation. The present implementation of free does not change the contents; but it is unwise to 
depend on this fact. 


Realloc changes the size of the block pointed to by ptr to size bytes and returns a pointer to the (possibly 
moved) block. The contents will be unchanged up to the lesser of the new and old sizes. 


Talloc inserts into the arena a designated block of store that was not previously known to the allocator. 


Calloc allocates space for an array of nelem elements of size elsize. The space is initialized to zeros. Cfree 
frees such a block. 


Each of the allocation routines returns a pointer to space suitably aligned (after possible pointer coercion) 
for storage of any type of object. 


The arena, though not necessarily contiguous, is kept in strict address order. Malloc allocates the first big 
enough contiguous reach of free space found in a circular search from the last block allocated or freed, coa- 
lescing adjacent free blocks as it searches. It calls sbrk (see break(2)) to get more memory from the system 
when there is no suitable space already free. It has been arranged that realloc will work on a block that has 
been freed, provided no other allocations have intervened. This questionable, unportable practice allows 
combinations of free, realloc and malloc to be used to rearrange the arena. 


SEE ALSO 


galloc(3), sbrk(2) 


DIAGNOSTICS 


BUGS 
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Malloc, realloc and calloc return a null pointer (0) if there is no available memory or if the arena has been 
detectably corrupted by storing outside the bounds of a block. A very stringently checking version of 
malloc, which aborts with a diagnostic if the arena is corrupted, can be created by recompilation with a 
debugging flag set; see the source. 


When realloc returns 0, the block pointed to by ptr may be destroyed. 
Malloc is general, not fast. A program that repeatedly allocates and frees a particular kind of block often 
can be speeded up by superimposing a block-cacheing or suballocation scheme on top of malloc-free. 


MAP(3X) Eighth Edition (local) MAP(3X) 


NAME 


orient, normalize — map projections 


SYNOPSIS 


orient(lat, lon, rot) 
float lat, lon, rot; 


struct place { 
float latrad, latsin, latcos; 
float lonrad, lonsin, loncos; 
}5 
normalize(p) 
struct place *p; 


int (*projection())0 


int project(p, xptr, yptr) 
struct place p; 
float *xptr, *yptr; 


DESCRIPTION 
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These functions are loaded with /d(1) option -Imap. Most of them calculate maps for a spherical earth. 
Each map projection is available in one standard form, into which data must be normalized for transverse or 
nonpolar projections. The projection is specified by invoking one of the following functions, known collec- 
tively as projection. Each function returns the name project of a function that will do the actual work of cal- 
culating coordinates, or 0 if the required projection is not available. The short summaries of properties per- 
tain to standard maps of the earth in standard orientation. 


Equatorial projections centered on the Prime Meridian (longitude 0). Parallels are straight horizontal lines. 


mercator() equally spaced straight meridians, conformal, straight compass courses 
sinusoidal() equally spaced parallels, equal-area 

cylequalarea(lat0) equally spaced straight meridians, equal-area, true scale on latO 
cylindrical() central projection on tangent cylinder 

rectangular() equally spaced straight parallels and meridians 

mollweide() (homalographic) equal-area, hemisphere is a circle 


Azimuthal projections centered on the North Pole. Parallels are concentric circles. Meridians are equally 
spaced radial lines. 


azequidistant() equally spaced parallels, true distances from pole 
azequalarea() equal-area 

gnomonic() central projection on tangent plane, straight great circles 
perspective(dist) viewed dist earth radii from center of earth 
orthographic() viewed from infinity 

stereographic() conformal, viewed from opposite pole 

laue() radius = tan(2xcolatitude), used in xray crystallography 


Polar conic projections symmetric about the Prime Meridian. Parallels are segments of concentric circles. 
Except in the Bonne projection, meridians are equally spaced radial lines orthogonal to the parallels. 


conic(lat0) central projection on cone tangent at latO 

bonne(lat0) equally spaced parallels, equal-area, parallel JatO developed from tangent cone 
lambert(lat0,lat1) conformal, true scale on /at0 and lat! 

albers(lat0,lat1) equal-area, true scale on Jat0 and latl 


Projections with bilateral symmetry about the Prime Meridian and the equator. 


polyconic() parallels developed from tangent cones uniformly distributed along Prime Meridian 
aitoff() equal-area projection of globe onto 2-to-1 ellipse, based on azimuthal equal area projection 
gilbert() conformal, maps whole sphere into a circle 
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bicentric(lon0) points plotted at true azimuth from two centers on the equator at longitudes t/on0, 
great circles are straight lines (a stretched gnomonic projection) 
elliptic(lon®) points are plotted at true distance from two centers on the equator at longitude tlon0 


Doubly periodic projections. 


guyou() conformal, W and E hemispheres are square 

square() conformal, world is square with Poles at diagonally opposite corners 

tetra() conformal map onto regular tetrahedron with an edge tangent to the Prime Meridian at the 
South Pole, developed into equilateral triangle 

hex() conformal map onto a hexagon centered on North Pole, N and S hemispheres are equilateral 
triangles 


Miscellaneous. 


mecca(lat0) equally spaced vertical meridians, straight line from any point to ‘Mecca’ (/at0 on the 
Prime Meridian) has the true bearing of Mecca 


Maps based on the spheroid. Of geodetic quality, these projections do not make sense for tilted orientations 
(see below). For descriptions, see corresponding maps above. 


sp_mercator() 
sp_albers(lat0,lat1) 


The project functions return a value | for a good point, 0 for a point on a wrong sheet (for example the back 
of the world in a perspective projection), and —1 for a point that is deemed unplottable. 


Each standard projection is displayed with the Prime Meridian being a straight vertical line, along which 
North is up. The orientation of nonstandard projections is specified by orient. Imagine a transparent grid- 
ded sphere around the globe. First turn the overlay about the North Pole so that the Prime Meridian (longi- 
tude 0) of the overlay coincides with meridian Jon on the globe. Then tilt the North Pole of the overlay 
along its Prime Meridian to latitude /at on the globe. Finally again turn the overlay about its ‘North Pole’ 
so that its Prime Meridian coincides with the previous position of meridian rot. Project the desired map in 
the standard form appropriate to the overlay, but presenting information from the underlying globe. 


Normalize converts latitude-longitude coordinates on the globe to coordinates on the overlaid grid. The 
coordinates and their sines and cosines are input to normalize in a structure pointed to by p. Transformed 
coordinates and their sines and cosines are returned in the same structure. 


The project functions convert normalized coordinates in the structure pointed to by p to x-y coordinates for 
the desired map. Scaling may be determined from the x-y coordinates of selected points. 


Latitudes and longitudes are measured in degrees for ease of specification for orient and projection, but in 
radians for ease of calculation for normalize and project. In either case latitude is measured positive north 
of the equator, and longitude positive west of Greenwich. Radian longitude should be limited to the range 
—mSlon<n. 


SEE ALSO 
map(7), map(5), plot(3) 
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NAME 
memccpy, memchr, memcmp, memcpy, memset — memory operations 
SYNOPSIS 
char *memccpy (s1, s2, c, n) 
char *s1, *s2; 
int c, n; 
char *memchr (s, c, n) 
char *s; 
int c, n; 
int memcmp (s1, s2, n) 
char *s1, *s2; 
int n; 
char *memcpy (s1, s2, n) 
char *s1, *s2; 
int n; 
char *memset (s, c, n) 
char *s; 
int c, n; 
DESCRIPTION 
These functions operate as efficiently as possible on memory areas (arrays of characters bounded by a 
count, not terminated by a null character). They do not check for the overflow of any receiving memory 
area. 
Memccpy copies characters from memory area s2 into s/, stopping after the first occurrence of character c 
has been copied, or after n characters have been copied, whichever comes first. It returns a pointer to the 
character after the copy of c in s/, or zero if c was not found in the first n characters of s2. 
Memchr returns a pointer to the first occurrence of character c in the first n characters of memory area s, or 
zero if c does not occur. 
Memcmp compares its arguments, looking at the first n characters only, and returns an integer less than, 
equal to, or greater than 0, according as s/ is lexicographically less than, equal to, or greater than s2. 
Memcpy copies n characters from memory area s2 to s/. It returns s/. 
Menmset sets the first n characters in memory area s to the value of character c. It returns s. 
SEE ALSO 
string(3) 
BUGS 
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Memcmp use native character comparison, which is signed on some machines, unsigned on others; thus the 
sign of the value returned when a character has its high-order bit set is implementation-dependent. 
The outcome of overlapping moves varies among implementations. 
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NAME 
mktemp, tmpnam — make a unique file name 


SYNOPSIS 
char *mktemp(template) 
char «template; 
#include <stdio.h> 


char *tmpnam(s) 
char s[L_tmpnam]; 

DESCRIPTION 
Mktemp replaces template by a unique file name, and returns the address of the template. The template 
should look like a file name with six trailing X’s, which will be replaced with the current process id and a 
unique letter. 


Tmpnam places in the string pointed to by s a unique file name referring to a standard directory for tempo- 
rary files (/tmp) and returns s. If s is 0, tmpnam returns the address of a fixed internal buffer that contains 
the name. (Note: it is bad form to leave files in the temporary directory.) 


SEE ALSO 
getuid(2) for getpid 


BUGS 
Tmpnam should not be tied to stdio(3). 
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NAME 


monitor — prepare execution profile 


SYNOPSIS 


monitor(lowpc, highpc, buffer, bufsize, nfunc) 
int («lowpc)(), (*highpe)(); 
short buffer[]; 


DESCRIPTION 


FILES 


An executable program created by ‘cc —p’ automatically includes calls for monitor with default parameters; 
monitor needn't be called explicitly except to gain fine control over profiling. 


Monitor is an interface to profil(2). Lowpc and highpc are the addresses of two functions; buffer is the 
address of a (user supplied) array of bufsize short integers. Monitor arranges to record a histogram of peri- 
odically sampled values of the program counter, and of counts of calls of certain functions, in the buffer. 
The lowest address sampled is that of Jowpc and the highest is just below highpc. At most nfunc call 
counts can be kept; only calls of functions compiled with the profiling option —p of cc(1) are recorded. For 
the results to be significant, especially where there are small, heavily used routines, it is suggested that the 
buffer be no more than a few times smaller than the range of locations sampled. 


To profile the entire program, it is sufficient to use 


extern etext(); 


monitor((int) 2, etext, buf, bufsize, nfunc); 

Etext lies just above all the program text, see end(3). 

To stop execution monitoring and write the results on the file mon.out, use 
monitor(0); 


then prof(1) can be used to examine the results. 


mon.out 


SEE ALSO 


Page | 


prof(1), profil(2), cc(1) 


MP(3X) 


NAME 


Eighth Edition MP(3X) 


itom, madd, msub, mmul, mdiv, msqrt, mgcd, mget, mput, mmov, mcmp, mexp, mpow — multiple preci- 
sion integer arithmetic 


SYNOPSIS 


#include <mp.h> 


mint *itom(n) 
int n; 

madd(a, b, c) 
msub(a, b, c) 
mmul(a, b, c) 
mgcd(a, b, c) 
mdiv(a, b, q, r) 
msqrt(a, b, r) 
mexp(a, b, c) 
mpow/(a, b, m, c) 
mmov(a, b) 
mecmp(a, b) 
mget(a) 

mput(a) 

mint *a, *b, *c, *m, *q, *F3 


sdiv(a, n, q, r) 
mint *a, *q; 
int n; 

short *r; 


DESCRIPTION 


These routines perform arithmetic on arbitrary-length integers of defined type mint. The functions are 
obtained with /d(1) option -lmp. 


Pointers to mint must be initialized using the function itom, which sets the initial value to n. Thereafter 
space is managed automatically by the routines. 


Madd, msub, mmul, and mgcd assign to their third arguments the sum, difference, product, and greatest 
common divisor, respectively, of their first two arguments. 


Madiv assigns the quotient and remainder, respectively, to its third and fourth arguments. Sdiv is like mdiv 
except that the divisor is an ordinary integer. 


Msqrt assigns to its second and third arguments the square root and remainder, repsectively, of its first argu- 
ment. 


Mexp calculates a raised to the power b; mpow calculates this reduced modulo m. 
Mmoy assigns the value of its first argument to its second argument. 


Mcmp returns a negative, zero, or positive integer if the value of its first argument is less than, equal to, or 
greater than, respectively, the value of its second argument. 


Mget and mput do decimal conversion from ‘stdin’ and to ‘stdout’, respectively, of stdio(3). 


DIAGNOSTICS 
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Illegal operations and running out of memory produce messages and core images. 


NLIST (3) Eighth Edition NLIST(3) 


NAME 
nlist — get entries from name list 


SYNOPSIS 
#include <nlist.h> 
nlist(filename, nl) 
char *filename; 
struct nlist nl[]; 
DESCRIPTION 
Nlist examines the name list in the given executable output file and selectively extracts a list of values. The 
name list consists of an array of structures containing names, types and values. The list is terminated with a 
null name. Each name is looked up in the name list of the file. If the name is found, the type and value of 


the name are inserted in the next two fields. If the name is not found, both entries are set to 0. See a.out(5) 
for the structure declaration. 


This subroutine is useful for examining the system name list kept in ‘/unix’ . In this way programs can 
obtain system addresses that are up to date. 


SEE ALSO 

a.out(5) 
DIAGNOSTICS 

All type entries are set to 0 if the file cannot be found or if it is not a valid namelist. 
BUGS 


On other versions of UNIX you must include <a.out.h> rather than <nlist-h>. This is unfortunate, but 
<a.out.h> can’t be used on the VAX because it contains a union, which can’t be initialized. 
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NAME 

perror, sys_errlist, sys_nerr — system error messages 
SYNOPSIS 

perror(s) 

char *s; 


int sys_nerr; 
char *sys_errlist[]; 
DESCRIPTION 
Perror produces a short error message on the standard error file describing the last error encountered during 
a call to the system from a C program. First the argument string s is printed, then a colon, then the message 


and a new-line. The error number is taken from the external variable errno (see intro(2)), which is set 
when errors occur but not cleared when non-erroneous calls are made. 


Sys_errlist is a vector of message strings. Errno can be used as an index in this table to get the message 
string without the newline. Sys_nerr is the number of messages in the table. 


SEE ALSO 
intro(2) 
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NAME 

vec, move, etc. — graphics interface 
SYNOPSIS 

#include <pplot.h> 


#include <plot.h> 
#include <iplot.h> 


openpl(s) char *s; 

closepl() 

erase() 

move(x, y) double x, y; 

rmove(dx, dy) double dx, dy; 

point(x, y) double dx, dy; 

vec(x, y) double x, y; 

rvec(dx, dy) double dx, dy; 

line(x1, yl, x2, y2) double x1, yl, x2, y2; 
arc(x1, yl, x2, y2, x, y, r) double x1, yl, x2, y2, x, y, r; 
circle(xc, yc, r) double xc, ye, r; 

box(x1, yl, x2, y2) double x1, yl, x2, y2; 
sbox(x1, yl, x2, y2) double x1, y1, x2, y2; 
parabola(x1, y1, x2, y2, x3, y3) double x1, y1, x2, y2, x3, y3; 
fill(n, arr) int n[]; double «arr[]; 

poly(n, arr) int n[]; double «arr[]; 
spline(n, arr) int n[]; double *arr[]; 
cspline(n, arr) int n[]; double «arr[]; 
fspline(m, arr) int n[]; double «arr[]; 
Ispline(n, arr) int n[]; double «arr[]; 
dspline(n, arr) int n[]; double *arr[]; 
text(s) char *s; 

color(s) char *s; 

cfill(s) char *s; 

pen(s) char *s; 

range(x1, y1, x2, y2) double x1, y1, x2, y2; 
frame(x1, y1, x2, y2) double x1, yl, x2, y2; 
grade(x) double x; 

save() 

restore() 

ppause() 


DESCRIPTION 
These functions generate either a device-independent graphic stream (see plot(5)) or device-dependent 
graphics commands. For device-independent graphic stream, include file <plot.h> for floating point argu- 
ments; and file <iplot.h> for integer arguments. The libraries for different devices are loaded with the fol- 
lowing /d(1) flags: 


-Iplot general stream output 

-12621 HP2621 terminal 

-14014 Tektronix 4014 terminal 

-Iram = Ramtek 9300 display 

-ltr Troff input, tuned for the Mergenthaler Linotron 202 phototypesetter 
-Ipen HP7580 pen plotter 

—Iblit blit terminal running mux 

-15620 5620 terminal running mux 
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String arguments are null terminated and may not contain embedded newlines. For details on string argu- 
ments, see plot(5). Poly, fill, and the various spline functions take an integer array and an array of pointers 
to double floating point arrays. The integers specify the number of vertices (x-y pairs) in the floating point 
array. The last integer entry should be 0. 


SEE ALSO 
plot(1), plot(5) 
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NAME 
popen, pclose — initiate IO to/from a process 


SYNOPSIS 
#include <stdio.h> 


FILE *popen(command, type) 
char *command, *type; 
pclose(stream) 
FILE «stream; 
DESCRIPTION 
The arguments to popen are pointers to null-terminated strings containing respectively a shell command 
line and an IO mode, either "r" for reading or "w" for writing. It creates a pipe between the calling process 


and the command to be executed. The value returned is a stream pointer that can be used (as appropriate) to 
write to the standard input of the command or read from its standard output. 


A stream opened by popen should be closed by pclose, which waits for the associated process to terminate 
and returns the exit status of the command. 


Wo 


Because open files are shared, a type "r" command may be used as an input filter, and a type "Ww" as an out- 
put filter. 
SEE ALSO 
pipe(2), fopen(3), fclose(3), system(3), wait(2) 
DIAGNOSTICS 
Popen returns a null pointer if files or processes cannot be created, or the Shell cannot be accessed. 
Pclose returns —1 if there is no process to wait for. 
BUGS 


Buffered reading before opening an input filter may leave the standard input of that filter mispositioned. 
Similar problems with an output filter may be forestalled by calling fflush; see fclose(3). 
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NAME 

port — mathematical library for Fortran 
SYNOPSIS 

{77 argument ... —-Iport 
DESCRIPTION 


The Port library of hundreds of scientific subroutines covers approximation, ordinary differential equations, 
partial Differential Equations, linear algebra, optimization and mathematical programming, quadrature, dif- 
ferentiation, roots, special functions, and transforms. It is built upon a framework of service routines for 
error handling, stack management, and machine constant parameterization. 


The manual describes the software and gives examples. 


SEE ALSO 
P. A. Fox, The PORT Mathematical Subroutine Library, AT&T Bell Laboratories, May 8, 1984. 
P. A. Fox, The PORT Mathematical Subroutine Library Installation Manual, AT&T Bell Laboratories, 
September, 1984. 
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NAME 


printf, fprintf, sprintf — print formatted output 


SYNOPSIS 


#include <stdio.h> 


int printf (format [, arg]... ) 
char «format; 


int fprintf (stream, format [, arg]... ) 
FILE *stream; 
char «format; 


int sprintf (s, format [, arg]... ) 
char *s, format; 


DESCRIPTION 
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Printf places output on the standard output stream stdout. Fprintf places output on the named output 
stream. Sprintf places ‘‘output,’’ followed by the null character (\0), in consecutive bytes starting at *s; it 
is the user’s responsibility to ensure that enough storage is available. Each function returns the number of 
characters transmitted (not including the \0 in the case of sprintf), or a negative value if an output error was 
encountered. 


Each of these functions converts, formats, and prints its args under control of the format. The format is a 
character string that contains two types of objects: plain characters, which are simply copied to the output 
stream, and conversion specifications, each of which results in fetching of zero or more args. The results 
are undefined if there are insufficient args for the format. If the format is exhausted while args remain, the 
excess args are simply ignored. 


Each conversion specification is introduced by the character %. After the %, the following appear in 
sequence: 


Zero or more flags, which modify the meaning of the conversion specification. 


An optional decimal digit string specifying a minimum field width. If the converted value has 
fewer characters than the field width, it will be padded on the left (or right, if the left-adjustment 
flag ‘—’, described below, has been given) to the field width. 


A precision that gives the minimum number of digits to appear for the d, 0, u, x, or X conver- 
sions, the number of digits to appear after the decimal point for the e and f conversions, the maxi- 
mum number of significant digits for the g conversion, or the maximum number of characters to be 
printed from a string in s conversion. The precision takes the form of a period (.) followed by a 
decimal digit string; a null digit string is treated as zero. 


An optional I (ell) specifying that a following d, 0, u, x, or X conversion character applies to a 
long integer arg. A 1 before any other conversion character is ignored. 


A character that indicates the type of conversion to be applied. 


A field width or precision may be indicated by an asterisk (*) instead of a digit string. In this case, an inte- 
ger arg supplies the field width or precision. The arg that is actually converted is not fetched until the con- 
version letter is seen, so the args specifying field width or precision must appear before the arg (if any) to 
be converted. 


The flag characters and their meanings are: 
- The result of the conversion will be left-justified within the field. 


+ The result of a signed conversion will always begin with a sign (+ or -). 

blank If the first character of a signed conversion is not a sign, a blank will be prefixed to the result. 
This implies that if the blank and + flags both appear, the blank flag will be ignored. 

# This flag specifies that the value is to be converted to an “‘alternate form.’’ For c, d,s, and u 


conversions, the flag has no effect. For 0 conversion, it increases the precision to force the first 
digit of the result to be a zero. For x or X conversion, a non-zero result will have Ox or 0X 
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prefixed to it. For e, E, f, g, and G conversions, the result will always contain a decimal point, 
even if no digits follow the point (normally, a decimal point appears in the result of these con- 
versions only if a digit follows it). For g and G conversions, trailing zeroes will not be 
removed from the result (which they normally are). 


The conversion characters and their meanings are: 


d,o,u,x,X 


e,E 


g.G 


% 


The integer arg is converted to signed decimal, unsigned octal, decimal, or hexadecimal nota- 
tion (x and X), respectively; the letters abcdef are used for x conversion and the letters 
ABCDEF for X conversion. The precision specifies the minimum number of digits to appear; if 
the value being converted can be represented in fewer digits, it will be expanded with leading 
zeroes. (For compatibility with other versions of printf, a field width with a leading zero will 
result in padding with leading zeroes. This does not imply an octal value for the field width.) 
The default precision is 1. The result of converting a zero value with a precision of zero is a 
null string. 

The float or double arg is converted to decimal notation in the style ‘‘[—]ddd.ddd,’’ where the 
number of digits after the decimal point is equal to the precision specification. If the precision 
is missing, six digits are output; if the precision is explicitly 0, no decimal point appears. 

The float or double arg is converted in the style ‘‘[—]d.dddetdd,’’ where there is one digit 
before the decimal point and the number of digits after it is equal to the precision; when the 
precision is missing, six digits are produced; if the precision is zero, no decimal point appears. 
The E format code will produce a number with E instead of e introducing the exponent. The 
exponent always contains at least two digits. 

The float or double arg is printed in style f or e (or in style E in the case of a G format code), 
with the precision specifying the number of significant digits. The style used depends on the 
value converted: style e will be used only if the exponent resulting from the conversion is less 
than 4 or greater than the precision. Trailing zeroes are removed from the result; a decimal 
point appears only if it is followed by a digit. 

The character arg is printed. 

The arg is taken to be a string (character pointer) and characters from the string are printed 
until a null character (\0) is encountered or the number of characters indicated by the precision 
specification is reached. If the precision is missing, it is taken to be infinite, so all characters 
up to the first null character are printed. A NULL value for arg will yield undefined results. 
(For compatibility with other versions of printf, a field width with a leading zero will result in 
zero-padding the string instead of blank-padding it. This does not imply an octal value for the 
field width.) 

Print a %; no argument is converted. 


In no case does a non-existent or small field width cause truncation of a field; if the result of a conversion is 
wider than the field width, the field is simply expanded to contain the conversion result. Characters gener- 
ated by printf and fprintf are printed as if putc(3S) had been called. 


EXAMPLES 


To print a date and time in the form “‘Sunday, July 3, 10:02,’’ where weekday and month are pointers to 
null-terminated strings: 


printf("%s, %s Yd, %d:%.2d", weekday, month, day, hour, min); 


To print 7 to 5 decimal places: 


printf("pi = %.5f", 4 * atan(1.0)); 


SEE ALSO 


ecvt(3C), putc(3S), scanf(3S), stdio(3S). 
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NAME 
ptopen — find and open a pseudo-terminal file 


SYNOPSIS 
int ptopen (name) 
char *name; 

DESCRIPTION 
Ptopen searches for a pseudo-terminal file pair it can open. If successful, it returns a file descriptor for the 
odd-numbered member of the pair, and places the name of the even-numbered member in name. There 
must be enough room in name to contain the full pathname. If unsuccessful, ptopen returns a negative 
value. 


SEE ALSO 
pt(4) 
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NAME 
putc, putchar, fputc, putw — put character or word on a stream 


SYNOPSIS 
#include <stdio.h> 


int putc(c, stream) 
char c; 
FILE *stream; 


putchar(c) 


fputc(c, stream) 
FILE *stream; 


putw(w, stream) 
FILE *stream; 


DESCRIPTION 
Putc appends the character c to the named output stream. It returns the character written. 


Putchar(c) is defined as putc(c, stdout). 


Fputc behaves like putc, but is a genuine function rather than a macro. It may be used to save on object 
text. 


Putw appends word (i.e. int) w to the output stream. It returns the word written. Putw neither assumes nor 
causes special alignment in the file. 


The standard stream stdout is normally buffered if and only if the output does not refer to a terminal, in 
which case buffering occurs only within calls to print{(3). This default may be changed by setbuf(3). The 
standard stream stderr is normally unbuffered; freopen (see fopen(3)) will cause it to become buffered. 
When an output stream is unbuffered information appears on the destination file or terminal as soon as writ- 
ten; when it is buffered many characters are saved up and written as a block. Fflush (see fclose(3)) may be 
used to force the block out early. 


SEE ALSO 
fopen(3), fclose(3), getc(3), puts(3), printf(3), fread(3) 


DIAGNOSTICS 
These functions return the constant EOF upon error. In the case of putw this indication is ambiguous; 
ferror(3) may be used to distinguish. 

BUGS 
Because it is implemented as a macro, putc treats a stream argument with side effects improperly. In par- 
ticular “putc(c, *f++)’ doesn’t work sensibly. 
Errors can occur long after the call to putc. 
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NAME 
puts, fputs — put a string on a stream 


SYNOPSIS 
#include <stdio.h> 


puts(s) 
char *s; 


fputs(s, stream) 
char *s; 
FILE *stream; 


DESCRIPTION 
Puts copies the null-terminated string s to the standard output stream stdout and appends a newline charac- 
ter. 


Fputs copies the null-terminated string s to the named output stream. 


Neither routine copies the terminal null character. 


SEE ALSO 
fopen(3), gets(3), putc(3), printf(3), ferror(3) 
fread(3) for fwrite 

BUGS 


Puts appends a newline, fputs does not, all in the name of backward compatibility. 
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NAME 
qsort — quicker sort 


SYNOPSIS 
qsort(base, nel, width, compar) 
char *base; 
int («compar)(); 


compar(a, b) 
char *a, *b; 


DESCRIPTION 
Qsort is an implementation of the quicker-sort algorithm. The first argument is a pointer to the base of the 
data; the second is the number of elements; the third is the width of an element in bytes; the last is the name 
of the comparison routine to be called with two arguments which are pointers to the elements being com- 
pared. The routine must return an integer less than, equal to, or greater than 0 according as the first argu- 
ment is to be considered less than, equal to, or greater than the second. 


SEE ALSO 
sort(1) 
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NAME 
rand, lrand, frand, nrand, srand — random number generator 
SYNOPSIS 
int rand( ) 
long Irand( ) 
double frand( ) 
int nrand(val) 
int val; 
srand(seed) 
int seed; 
DESCRIPTION 
Rand uses a polynominal feedback random number generator with period 2*°_2*” to return successive uni- 
form pseudo-random numbers x, 0<x<2), 
Lrand returns a uniform long x, 0<x<27), 
Frand returns a uniform double x, 0.0<x<1.0. 
Nrand returns a uniform integer x, 0<x<val. 
The generators are initialized by calling srand with whatever you like as argument. To get a different start- 
ing value each time, 
srand((int)time(0)) 
should work as long as it is not called more often than once per second. 
BUGS 
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Rand and Irand are quite machine-dependent. In principle frand and nrand are more portable, but only the 
Eighth Edition has them. 
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NAME 
re_comp, re_exec — regular expression handler 

SYNOPSIS 
char *re_comp(s) 
char *s; 
re_exec(s) 
char *s; 

DESCRIPTION 
Re_comp compiles a regular expression into an internal form suitable for pattern matching. Re_exec checks 
the argument string against the last string passed to re_comp. 
Re_comp returns 0 if the string s was compiled successfully; otherwise a string containing an error message 
is returned. If re_comp is passed 0 or a null string, it returns without changing the currently compiled regu- 
lar expression. 
Re_exec returns | if the string s matches the last compiled regular expression, 0 if the string s failed to 
match the last compiled regular expression, and —1 if the compiled regular expression was invalid (indicat- 
ing an internal error). 
The strings passed to both re_comp and re_exec may have trailing or embedded newline characters; they 
are terminated by nulls. The regular expressions are otherwise as described for ed(1). 

SEE ALSO 
ed(1), expr(1), regexp(3) 

DIAGNOSTICS 
Re_exec returns —1 for an internal error. 

BUGS 


These routines have been superseded by the more general routines of regexp(3). They have been retained 
only for compatibility. 
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NAME 


regcomp, regexec, regsub, regerror — regular expression handler 


SYNOPSIS 


#include <regexp.h> 


regexp *regcomp(exp) 
char “exp; 


int regexec(prog, string) 
struct regexp *prog; 
char *string; 


regsub(prog, source, dest) 
struct regexp *prog; 

char «source; 

char «dest; 


regerror(msg) 
char «msg; 


DESCRIPTION 


Regcomp compiles an egrep(1)-styleregularexpressionandreturns a pointer to an object with the following 
structure. The object is allocated by malloc(2) and may be released by free. 


#define NSUBEXP 10 
typedef struct regexp { /* see regexp(3) */ 
char *startp[NSUBEXP]; 
char *endp[NSUBEXP]; 
char program[1]; 
} regexp; 
Startp[n] points to the first character of the substring of string that matches the nth parenthesized subex- 
pression (the subexpression introduced by the nth left parenthesis). Endp|n] points to the first character 
following that substring. The character array program contains the compiled form of the regular expres- 
sion. 


Regexec matches a null-terminated string against the compiled regular expression in prog. If it matches, 
regexec returns a non-zero value and fills in the startp and endp fields to describe the match, in which **’, 
‘+’, and ‘?’ matches are extended as far as possible. By convention, startp[0] and endp[0] refer to the sub- 
string that matches the complete regular expression. 


Regsub places in dest a substitution instance of source in the context of the last regexec performed using 
prog. Each instance of ‘\n’, where n is a digit, is replaced by the string delimited by startp[n] and endp[n]. 
Each instance of ‘&’ is replaced by the string delimited by startp [0] and endp [0]. The result is placed in 
the area pointed to by dest . 


Regerror, called whenever an error is detected in regcomp, regexec, or regsub, writes the string msg on the 
standard error file and exits. Regerror can be replaced to perform special error processing. 


DIAGNOSTICS 


Regcomp returns 0 for an illegal expression or other failure. Regexec returns 0 if string is not accepted. 


SEE ALSO 
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egrep(1), expr(1) 
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NAME 


scanf, fscanf, sscanf — formatted input conversion 


SYNOPSIS 


#include <stdio.h> 


scanf(format [ , pointer]... ) 
char «format; 


fscanf(stream, format [ , pointer]... ) 
FILE *stream; 
char «format; 


sscanf(s, format [ , pointer]... ) 
char *s, *format; 


DESCRIPTION 
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Scanf reads from the standard input stream stdin. Fscanf reads from the named input stream. Sscanf reads 
from the character string s. Each function reads characters, interprets them according to a format, and 
stores the results in its arguments. Each expects as arguments a control string format, described below, and 
a set of pointer arguments indicating where the converted input should be stored. 


The control string usually contains conversion specifications, which are used to direct interpretation of 
input sequences. The control string may contain: 


1. Blanks, tabs or newlines, which match optional white space in the input. 
2. An ordinary character (not %) which must match the next character of the input stream. 


3. Conversion specifications, consisting of the character %, an optional assignment suppressing character 
*, an optional numerical maximum field width, and a conversion character. 


A conversion specification directs the conversion of the next input field; the result is placed in the variable 
pointed to by the corresponding argument, unless assignment suppression was indicated by *. An input 
field is defined as a string of non-space characters; it extends to the next inappropriate character or until the 
field width, if specified, is exhausted. 


The conversion character indicates the interpretation of the input field; the corresponding pointer argument 
must usually be of a restricted type. The following conversion characters are legal: 


% asingle ‘%’ is expected in the input at this point; no assignment is done. 

d =a decimal integer is expected; the corresponding argument should be an integer pointer. 

0 an octal integer is expected; the corresponding argument should be a integer pointer. 

x ahexadecimal integer is expected; the corresponding argument should be an integer pointer. 


s acharacter string is expected; the corresponding argument should be a character pointer pointing to an 
array of characters large enough to accept the string and a terminating ‘\0’, which will be added. The 
input field is terminated by a space character or a newline. 


ce  acharacter is expected; the corresponding argument should be a character pointer. The normal skip 
over space characters is suppressed in this case; to read the next non-space character, try ‘%1s’. Ifa 
field width is given, the corresponding argument should refer to a character array, and the indicated 
number of characters is read. 


e _a floating point number is expected; the next field is converted accordingly and stored through the cor- 

f responding argument, which should be a pointer to a float. The input format for floating point num- 
bers is an optionally signed string of digits possibly containing a decimal point, followed by an 
optional exponent field consisting of an E or e followed by an optionally signed integer. 


[ indicates a string not to be delimited by space characters. The left bracket is followed by a set of char- 
acters and a right bracket; the characters between the brackets define a set of characters making up the 
string. If the first character is not circumflex (*), the input field is all characters until the first character 
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not in the set between the brackets; if the first character after the left bracket is *, the input field is all 
characters until the first character which is in the remaining set of characters between the brackets. 
The corresponding argument must point to a character array. 


The conversion characters d, 0 and x may be capitalized or preceded by | to indicate that a pointer to long 
rather than to int is in the argument list. Similarly, the conversion characters e or f may be capitalized or 
preceded by I to indicate a pointer to double rather than to float. The conversion characters d, 0 and x may 
be preceded by h to indicate a pointer to short rather than to int. 


The scanf functions return the number of successfully matched and assigned input items. This can be used 
to decide how many input items were found. The constant EOF is returned upon end of input; note that this 
is different from 0, which means that no conversion was done; if conversion was intended, it was frustrated 
by an inappropriate character in the input. 


For example, the call 


int i; float x; char name[50]; 
scanf("%d%f%s", &i, &x, name); 


with the input line 
25 54.32E—-1 thompson 
will assign to 7 the value 25, x the value 5.432, and name will contain ‘thompson\0’. Or, 


int 1; float x; char name[50]; 
scanf("%2d%f%*d%[1234567890]", &1, &x, name); 


with input 
56789 0123 56a72 


will assign 56 to i, 789.0 to x, skip ‘0123’, and place the string ‘56\0’ in name. The next call to getchar 
will return ‘a’. 


SEE ALSO 
atof(3), getc(3), printf(3) 


DIAGNOSTICS 
The scanf functions return EOF on end of input, and a short count for missing or illegal data items. 


BUGS 
The success of literal matches and suppressed assignments is not directly determinable. 
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NAME 
setbuf — assign buffering to a stream 


SYNOPSIS 
#include <stdio.h> 


setbuf(stream, buf) 
FILE *stream; 
unsigned char «buf; 


DESCRIPTION 
Setbuf is used after a stream has been opened but before it is read or written. It causes the character array 
buf to be used instead of an automatically allocated buffer. If buf is the constant pointer NULL, 
input/output will be completely unbuffered. 


A manifest constant BUFSIZ tells how big an array is needed: 
unsigned char buf[BUFSIZ]; 


A buffer is normally obtained from malloc(3) upon the first getc or putc(3) on the file, except that the stan- 
dard output is line buffered when directed to a terminal. Other output streams directed to terminals, and the 
standard error stream stderr are normally not buffered. If the standard output is line buffered, then it is 
flushed each time data is read from the standard input by read(2). 


SEE ALSO 
fopen(3), getc(3), putc(3), malloc(3) 
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NAME 
setjmp, longjmp — non-local goto 
SYNOPSIS 
#include <setjmp.h> 
setjmp(env) 
jmp_buf env; 
longjmp(env, val) 
jmp_buf env; 
DESCRIPTION 


These routines are useful for dealing with errors and interrupts encountered in a low-level subroutine of a 
program. 


Setjmp saves its stack environment in env for later use by /ongjmp. It returns value 0. 


Longjmp restores the environment saved by the last call of setjmp. It then returns in such a way that execu- 
tion continues as if the call of setjmp had just returned the value val to the function that invoked setjmp, 
which must not itself have returned in the interim. All accessible data have values as of the time longjmp 
was called. 


SEE ALSO 
signal(2) 
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NAME 
sin, cos, tan, asin, acos, atan, atan2 — trigonometric functions 


SYNOPSIS 
#include <math.h> 


double sin(x) 
double x; 


double cos(x) 
double x; 


double asin(x) 
double x; 


double acos(x) 
double x; 


double atan(x) 
double x; 


double atan2(x, y) 
double x, y; 


DESCRIPTION 
Sin, cos and tan return trigonometric functions of radian arguments. The magnitude of the argument should 
be checked by the caller to make sure the result is meaningful. 


Asin returns the arc sin in the range —1/2 to 77/2. 

Acos returns the arc cosine in the range 0 to 7. 

Atan returns the arc tangent of x in the range —7/2 to 7/2. 
Atanz2 returns the arc tangent of x/y in the range —2 to 7. 


DIAGNOSTICS 
Arguments of magnitude greater than | cause asin and acos to return value 0; errno is set to EDOM. The 
value of tan at its singular points is a huge number, and errno is set to ERANGE. 


BUGS 
The value of tan for arguments greater than about 2**31 is garbage. 
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NAME 
sinh, cosh, tanh — hyperbolic functions 


SYNOPSIS 
#include <math.h> 


double sinh(x) 
double x; 


double cosh(x) 
double x; 


double tanh(x) 
double x; 


DESCRIPTION 
These functions compute the designated hyperbolic functions for real arguments. 


DIAGNOSTICS 
Sinh and cosh return a huge value of appropriate sign when the correct value would overflow. 
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NAME 
sleep — suspend execution for an interval 


SYNOPSIS 
sleep(seconds) 
unsigned seconds; 


DESCRIPTION 
The current process is suspended from execution for the number of seconds specified by the argument. The 
actual suspension time may be up to 1| second less than that requested, because scheduled wakeups occur at 
fixed 1-second intervals, and an arbitrary amount longer because of other activity in the system. 


The routine is implemented by setting an alarm clock signal and pausing until it occurs. The previous state 
of this signal is saved and restored. If the sleep time exceeds the time to the alarm signal, the process sleeps 
only until the signal would have occurred, and the signal is sent 1 second later. 


SEE ALSO 
alarm(2), pause(2) 
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NAME 


stdio — standard buffered input/output package 


SYNOPSIS 


#include <stdio.h> 


FILE *stdin; 
FILE «stdout; 
FILE «stderr; 


DESCRIPTION 


The functions described in Sections 3S constitute an efficient user-level buffering scheme. The in-line mac- 
ros getc and putc(3) handle characters quickly. The higher level routines gets, fgets, scanf, fscanf, fread, 
puts, fputs, printf, fprintf, fwrite all use getc and putc; they can be freely intermixed. 


A file with associated buffering is called a stream, and is declared to be a pointer to a defined type FILE. 
Fopen(3) creates certain descriptive data for a stream and returns a pointer to designate the stream in all 
further transactions. There are three normally open streams with constant pointers declared in the include 
file and associated with the standard open files: 


stdin standard input file 
stdout standard output file 
stderr standard error file 


A constant ‘pointer’ NULL (0) designates no stream at all. 


An integer constant EOF (—1) is returned upon end of file or error by integer functions that deal with 
streams. 


Any routine that uses the standard input/output package must include the header file <stdio.h> of pertinent 
macro definitions. The functions and constants mentioned in sections labeled 3S are declared in the include 
file and need no further declaration. The constants, and the following ‘functions’ are implemented as mac- 
ros; redeclaration of these names is perilous: getc, getchar, putc, putchar, feof, ferror, fileno. 


SEE ALSO 


open(2), close(2), read(2), write(2) 


DIAGNOSTICS 


BUGS 
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The value EOF is returned uniformly to indicate that a FILE pointer has not been initialized with fopen, 
input (output) has been attempted on an output (input) stream, or a FILE pointer designates corrupt or other- 
wise unintelligible FILE data. 


Buffering of output can prevent output data from being seen until long after it is computed — perhaps never, 
as when an abort occurs between buffer filling and flushing. 

Buffering of input can cause a process to consume more input than it actually uses. This can cause trouble 
across exec (2) or system (3) calls. 
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NAME 


strcat, strncat, strcmp, strncmp, strcpy, strncpy, strlen, strchr, strrchr, strpbrk, strspn, strcspn, strtok, index, 
rindex — string operations 


SYNOPSIS 


#include <string.h> 


char *strcat(s1, s2) 
char *s1, *s2; 


char *strncat(s1, s2, n) 
char *s1, *s2; 

int n; 

int stremp(s1, s2) 

char *s1, *s2; 


int strncmp(s1, s2, n) 
char *s1, *s2; 

int n; 

char *strepy(s1, s2) 
char *s1, *s2; 


char *strncpy(s1, s2, n) 
char *s1, *s2; 

int n; 

int strlen(s) 

char *s; 


char *strchr(s, c) 
char *s; 

int c; 

char *strrchr(s, c) 
char *s; 

int c; 

char *strpbrk(s1, s2) 
char *s1, *s2; 


int strspn(s1, s2) 
char *s1, *s2; 

int strespn(s1, s2) 
char *s1, *s2; 

char *strtok(s1, s2) 
char *s1, *s2; 


char *strdup(s) 
char *s; 


DESCRIPTION 
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The arguments s/, s2 and s point to null-terminated strings. The functions strcat, strncat, strcpy, and 
strncpy all alter s1. These functions do not check for overflow of the array pointed to by s/. 


Strcat appends a copy of string s2 to the end of string s/. Strncat appends at most n characters. Each 
returns a pointer to the null-terminated result. 


Strcmp compares its arguments and returns an integer less than, equal to, or greater than 0, according as s/ 
is lexicographically less than, equal to, or greater than s2. Strncmp makes the same comparison but looks 
at at most 7 characters. 
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Strcpy copies string s2 to s/, stopping after the null character has been copied. Strncpy copies exactly n 
characters, truncating s2 or adding null characters to s/ if necessary. The result will not be null-terminated 
if the length of s2 is n or more. Each function returns s/. 


Strlen returns the number of characters in s, not including the terminating null character. 


Strchr (strrchr) returns a pointer to the first (last) occurrence of character c in string s, or 0 if c does not 
occur in the string. The null character terminating a string is considered to be part of the string. Index and 
rindex are obsolete names for strchr and strrchr. 


Strpbrk returns a pointer to the first occurrence in string s/ of any character from string s2, 0 if no character 
from s2 exists in s/. 


Strspn (strcespn) returns the length of the initial segment of string s/ which consists entirely of characters 
from (not from) string 52. 


Strtok considers the string s/ to consist of a sequence of zero or more text tokens separated by spans of one 
or more characters from the separator string s2. The first call, with pointer s/ specified, returns a pointer to 
the first character of the first token, and will have written a null character into s/ immediately following the 
returned token. The function keeps track of its position in the string between separate calls; subsequent 
calls, signified by s/ being 0, will work through the string s/ immediately following that token. The sepa- 
rator string s2 may be different from call to call. When no token remains in s/, 0 is returned. 


Strdup returns a pointer to a distinct copy of the null-terminated string s in space obtained from malloc (3) 
or 0 if no space can be obtained. 


SEE ALSO 
memory(3) 


BUGS 
Stremp and strncmp use native character comparison, which is signed on some machines, unsigned on oth- 
ers, but consistent on ASCII characters. 
The outcome of overlapping moves varies among implementations. 
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NAME 
swab — swap bytes 


SYNOPSIS 
swab(from, to, nbytes) 
char «from, *to; 


DESCRIPTION 
Swab copies nbytes bytes pointed to by from to the position pointed to by to, exchanging adjacent even and 
odd bytes. It is useful for carrying binary data between PDP11’s and other machines. Nbytes should be 
even. 
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NAME 
system — issue a shell command 
SYNOPSIS 
system(string) 
char *string; 
DESCRIPTION 
System causes the string to be given to sh(1) as input as if the string had been typed as a command at a ter- 
minal. The current process waits until the shell has completed, then returns the exit status of the shell. 
SEE ALSO 
popen(3), exec(2), wait(2) 
DIAGNOSTICS 


Exit status 127 indicates the shell couldn’t be executed. 
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NAME 
tcp_sock, tcp_conn, tcp listen, tcp_accept, tcp_rcmd — tcp operations 
SYNOPSIS 
#include <sys/inet/tcp_user.h> 
tep_sockQ); 
tep_connect(fd, lport, faddr, fport) 
int fd; 
tep_port Iport, fport; 
in_addr faddr; 
tep_listen(fd, lport, faddr, fport) 
int fd; 
tep_port Iport, fport; 
in_addr faddr; 
tcep_accept(fd, faddrp, fportp, devp) 
int fd, *devp; 
in_addr *faddrp; 
tep_port «fportp; 
tep_remd (host, port, locuser, remuser, cmd, fd2p) 
char “host, «port, *locuser, *remuser, *cmd; 
int *fd2p; 
DESCRIPTION 


FILES 


These routines are loaded by the -lin option of /d(1). 


TCP is one of the many protocols which are layered upon IP (internet protocol). It provides full duplex 
byte stream connections between end points called sockets. The address of a socket is composed of the 
internet address of its host and the port number to which the socket is bound. 


Tcp_sock returns the file descriptor of an unbound socket. Once opened, a socket may be bound to a port 
number within the host and set up as the active or passive end of a connection. Tcp_sock returns -1 if no 
sockets are available. 


Tcp_connect binds socket fd to port /port and attempts to set up a connection to the socket bound to port 
Jport on host faddr. Tcp_connect returns 0 if the connection is established, -1 otherwise. Communications 
proceeds by performing read(2) and write (2) on fd. 


Tcp_listen binds socket fd to port /port and configures the socket to listen for connection requests to that 
port. If faddr and fport are non-zero, only connections coming from sockets on machine faddr and bound 
to port fport are listened for. Tcp_listen returns 0 on success, -1 otherwise. Select(2) can be used with a 
listening socket to provide asynchronous polling of connection requests. 


Tcp_accept waits for and accepts a connection request sent to the listening socket fd. When a connection 
arrives, tcp_accept fills in faddr and fport with the identity of the connector and returns a new fd over 
which communications can proceed. Fd is left open and continues listening for connections. 


Tcp_rcmd remotely executes a cmd on host as user remuser. Standard input is attached to cmd’s standard 
input and cmd’s standard output is attached to standard output. If fd2p is non-zero, it is filled with the fd of 
a new TCP connection attached to cmd’s standard error. Otherwise, cmd’s standard error is attached to its 
standard output. 


/dev/tcp* the socket devices 


SEE ALSO 
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NAME 
dkdial, dkerror — open a datakit connection to a remote server 

SYNOPSIS 
#include <dk.h> 
tdkdial(srvname, traffic) 
char *srvname; 
extern char *dkerror; 

DESCRIPTION 
These routines are loaded by option -Idk of /d(1). 
Tdkdial opens an available datakit channel, and attempts to connect it to the named server. The server is 
told the srvname string, the identity of the host computer originating the call, and the effective userid of the 
process making the request. If successful, the file descriptor of the open circuit is returned. 
Traffic type tells the network the characteristics of the intended traffic on this circuit. Current defined val- 
ues are 0 for terminal-like traffic, and 2 for high-speed host-host traffic. 
Srvname consists of a required network destination name, optionally followed by a period and some arbi- 
trary parameters for the server being called. A general destination name has three components, separated 
by slashes. The first is an area code (e.g. mh) the second is a controller node in that area (e.g. astro) the 
last is a service offered in that node. A standard service offered by each machine attached to a node is 
remote login, and the service name is the same as the machine name (e.g. research). 
The additional information is of limited length, and should only be used to inform the server what type of 
session is desired and what higher level protocol should be used to exchange further information. 

FILES 
/dev/dk directory containing files naming each channel 

SEE ALSO 
dkmer(3) 

DIAGNOSTICS 
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Value —1 returned on error, and pointer to diagnostic message stored in dkerror. 
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NAME 


tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs — terminal independent operation routines 


SYNOPSIS 


char PC; 
char *BC; 
char *UP; 
short ospeed; 


tgetent(bp, name) 
char *bp, *name; 


tgetnum(id) 
char *id; 


tgetflag(id) 
char *id; 


char * 
tgetstr(id, area) 
char *id, **area; 


char * 
tgoto(cm, destcol, destline) 
char *cm; 


tputs(cp, affcent, outc) 
register char *cp; 

int affent; 

int («outc)(; 


DESCRIPTION 
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These functions extract and use capabilities from the terminal capability data base termcap(5). These are 
low level routines; see curses(3) for a higher level package. 


Tgetent extracts the entry for terminal name into the buffer at bp. Bp should be a character buffer of size 
1024 and must be retained through all subsequent calls to tgetnum, tgetflag, and tgetstr. Tgetent returns —1 
if it cannot open the termcap file, 0 if the terminal name given does not have an entry, and | if all goes well. 
It will look in the environment for a TERMCAP variable. If found, and the value does not begin with a 
slash, and the terminal type name is the same as the environment string TERM, the TERMCAP string is 
used instead of reading the termcap file. If it does begin with a slash, the string is used as a path name 
rather than /etc/termcap. This can speed up entry into programs that call tgetent, as well as to help debug 
new terminal descriptions or to make one for your terminal if you can’t write the file /etc/termcap. 


Tgetnum gets the numeric value of capability id, returning —1 if is not given for the terminal. Tgetflag 
returns | if the specified capability is present in the terminal’s entry, 0 if it is not. Tgetstr gets the string 
value of capability id, placing it in the buffer at area, advancing the area pointer. It decodes the abbrevia- 
tions for this field described in termcap(5), except for cursor addressing and padding information. 


Tgoto returns a cursor addressing string decoded from cm to go to column destcol in line destline. It uses 
the external variables UP (from the up capability) and BC (if be is given rather than bs) if necessary to 
avoid placing \n, “D or “@ in the returned string. (Programs which call tgoto should be sure to turn off the 
XTABS bit(s), since tgoto may now output a tab. Note that programs using termcap should in general turn 
off XTABS anyway since some terminals use control I for other functions, such as nondestructive space.) 
If a % sequence is given which is not understood, then tgoto returns ‘OOPS’. 


Tputs decodes the leading padding information of the string cp; affcnt gives the number of lines affected by 
the operation, or | if this is not applicable, outc is a routine which is called with each character in turn. The 
external variable ospeed should contain the output speed of the terminal as encoded by stty (2). The external 
variable PC should contain a pad character to be used (from the pe capability) if a null ((@) is inappropri- 
ate. 
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FILES 
/asr/lib/libtermcap.a —ltermcap library 
/etc/termcap data base 
SEE ALSO 
ex(1), curses(3), termcap(5) 
AUTHOR 
William Joy 
BUGS 
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NAME 
tolower, toupper — force upper or lower case 


SYNOPSIS 
tolower(character) 


toupper(character) 


DESCRIPTION 
If character is an upper case letter, tolower returns the same lower case letter, otherwise it returns the origi- 


nal character. 
Toupper does the reverse. 


SEE ALSO 
ctype(3) 
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NAME 
ttyname, cttyname, isatty, ttyslot — find name of a terminal 


SYNOPSIS 
char *ttyname(fildes) 


char *cttyname() 
isatty(fildes) 
ttyslot() 


DESCRIPTION 
Ttyname returns a pointer to the null-terminated path name of the terminal device associated with file 


descriptor fildes. 


Cttyname returns a pointer to the path name of the terminal device associated with the first file descriptor 
among 0,1,2 that is connected to a terminal device. This probably is the control terminal for the present 
process. 


Isatty returns 1 if fildes is associated with a terminal device, 0 otherwise. 
Ttyslot returns the number of the entry in the ftys(5) file for the control terminal of the current process. 


FILES 
/dev/* 
/etc/ttys 


SEE ALSO 
ioctl(2), ttys(5) 


DIAGNOSTICS 
Ttyname returns a null pointer (0) if fildes does not describe a terminal device in directory ‘/dev’. 


Ttyslot returns 0 if ‘/etc/ttys’ is inaccessible or if it cannot determine the control terminal. 


BUGS 
The return value points to static data whose content is overwritten by each call. 
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udp_connect, udp listen, udp datagram — udp operations 


SYNOPSIS 


#include <sys/inet/udp_user.h> 


udp_connect(sport, dhost, dport) 
in_addr dhost; 

udp port sport, dport; 
udp_listen(sport, reply) 

udp _port sport; 

struct udpreply «reply; 


udp_datagram(sport) 
udp _ port sport; 


DESCRIPTION 


FILES 


These routines are loaded by the -lin option of /d(1). 


UDP is one of the many protocols which are layered upon IP (internet protocol). It provides datagram ser- 
vice between end points called sockets. A socket address is composed of the internet address of its host and 
the port number to which the socket is bound. 


Udp_connect returns the fd of a UDP socket bound to port sport. All writes(2) performed on this fd will be 
sent to the UDP socket at host dhost, port dport and reads(2) from this fd will only accept datagrams from 
that socket. Udp_connect returns -1 on failure. 


Udp_listen returns the fd of a UDP socket bound to port sport and waits for a datagram to be sent to that 
port. Once a message has been received from another socket, all writes(2) will go to that socket and 
reads(2) will only accept data from that socket. 


Udp_datagram returns the fd of a UDP socket bound to port sport. All messages written to the socket must 
start with a struct udpaddr which contains the destination of the message. 
struct udpaddr { /* from udp_user.h */ 

in_addr host; 

int port; 
ye 
All messages read from the socket also start with a struct udpaddr and contain the address of the source 
socket. 


/dev/udp* the socket devices 


SEE ALSO 
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internet(3), tep(3) 
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NAME 
ungetc — push character back into input stream 


SYNOPSIS 
#include <stdio.h> 


ungetc(c, stream) 
FILE *stream; 


DESCRIPTION 
Ungetc pushes the character c back on an input stream. That character will be returned by the next getc call 


on that stream. Ungetc returns c. 


One character of pushback is guaranteed provided something has been read from the stream and the stream 
is actually buffered. Attempts to push EOF are rejected. 


Fseek(3) erases all memory of pushed back characters. 


SEE ALSO 
getc(3), setbuf(3), fseek(3) 


DIAGNOSTICS 
Ungetc returns EOF if it can’t push a character back. 
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NAME 
varargs — variable argument list 


SYNOPSIS 
#include <varargs.h> 
function(va_alist) 
va_del 


va_list pvar; 
va_start(pvar); 
va_arg(pvar, type ); 
va_end(pvar); 


DESCRIPTION 
This set of macros allows portable procedures that accept variable argument lists to be written. Routines 
which have variable argument lists (such as printf(3)) that do not use varargs are inherently nonportable, 
since different machines use different argument passing conventions. 


The literal identifier va_alist is used in a function header to declare a variable argument list. It is declared 
by va_dcl. Note that there is no semicolon after va_dcl. 


Va_list is the type of the variable pvar, which is used to traverse the list. One variable of this type must 
always be declared. 


Va_start initializes pvar to the beginning of the list. 


Va_arg returns the next argument in the list pointed to by pvar. Type is the type the argument is expected 
to be. Different types can be mixed, but it is up to the routine to know what type is expected, since it can- 
not be determined at runtime. 


Va_end is used to finish up. 
Multiple traversals, each bracketed by va_start and va_end, are possible. 


EXAMPLE 
How to define exec! in terms of execv; see exec(2): 


#include <varargs.h> 
execl(va_alist) 


va_dcl 
{ 
va_list ap; 
char *file; 
char *args[100]; 


int argno = 0; 

va_start(ap); 

file = va_arg(ap, char*); 

while (args[argno++] = va_arg(ap, char*)) 
continue; 

va_end(ap); 

execv(file, args); 
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NAME 


view2d, moviefil — movie of a function f(x, y, t) 


SYNOPSIS 


view2d(fd, nx, ny, time, u, v, fixuv, pmin, pmax, p) 
short p[]; 
double time; 


moviefil(fd, nx, ny, time, outside, f) 
float time, outside, f[]; 


DESCRIPTION 


View2d writes a frame in the format view2d(5) onto the file specified by fd, a file descriptor for an open file. 
Use /d(1) option -lview2d. Nx, ny give the grid size. Time is a (nondecreasing) frame index, typically set 
to simulation time or iteration count. U and v describe the relation between pixel values and user function 
values: 


p=ut flr**y, 
U and v may vary from one frame to the next. When the global scaling is known beforehand, put fixuv = 1 


and set pmin and pmax to the limits of the data. (Otherwise put fixuv=0; pmin and pmax will be ignored.) 


P is the nx by ny array of pixel values, with the x index running fastest. There is a threshold for describing 
nonrectangular regions: any pixel value less than or equal to —32766 is treated as an out of bounds marker 
and will appear as black. Other pixel values should lie in the range [-32765,32765]. 


Moviefil is an alternate version that is somewhat less flexible but easier to use. It takes floats and scales 
automatically to shorts. Any array element f[i][j] less than outside is treated as undefined and will appear 
as black. 


SEE ALSO 
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view2d(1), view2d(5) 


BUFLD (4) Eighth Edition BUFLD(4) 


NAME 
buf_ld — buffering line discipline 


DESCRIPTION 
This stream module treasures up data for a while, then emits it in a burst. It is otherwise transparent. It 
intends to reduce overhead of programs such as cu(1) and uucp(1) that read input from moderate-speed 
lines in raw or cbreak mode. 


It saves characters until 16 are accumulated or 1/20 sec has passed without seeing a character. 


SEE ALSO 
stream(4) 


BUGS 
One supposes that the parameters should be settable. 


Page | 


CONNLD (4) Eighth Edition CONNLD(4) 


NAME 


connld — unique stream connection 


DESCRIPTION 
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This stream module (see stream(4)) is used to provide unique connections to a server. The file descriptor fd 
should refer to an end of a stream-—usually a pipe—that will subsequently be mounted onto a file by 
gmount(2). When an open or creat(2) call is applied to a stream-associated file with this module installed, 
a new pipe is created internally. A message identical to that described for the FIOSNDFD request (see 
stream(4)) is sent along the stream to the process at the other end. This process must respond in one of 
these ways: it may simply write some data, or reply with 


ioctl(fd1, FIOACCEPT, (char *)NULL); 


Then the attempt to open the stream succeeds, and the returned file descriptor refers to the new pipe, whose 
other end is held by the server process. It may also respond by passing a new file descriptor, using 


ioctl(fd1, FIOSNDFD, &fd2); 


Then the local end of the internally-created pipe is discarded, and the returned file descriptor refers to the 
transmitted file. 


On the other hand, if the server process closes the transmitted file descriptor, or does 
ioctl(fd1, FIOREJECT, (char *)NULL); 
then the attempt to open fails. 


Finally, if the entity, whether process or device, that receives the FIOSNDFD message fails to respond in 
some appropriate way, the process attempting to open the file will wait until it is sent a signal, or the system 
is rebooted, or the end of eternity, whichever comes first. 
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NAME 


cons — console interface 


DESCRIPTION 


FILES 


The console is available to the processor through the console registers. It acts like a normal terminal, 
except that when the local functions are not disabled, control-P puts the console in local console mode 
(where the prompt is “>>>’). On an 11/780, you can return to the conversational mode by ‘SE T P’ if the 
processor is still running or ‘CONTINUE’ if it is halted. On an 11/750, control-P always halts the proces- 
sor; ‘C’ will recover. 


If you hit the break key on an 11/780 console, the console may go into ODT (console debugger mode). Hit 
a ‘P’ to get out of this mode. 


With the above provisos the console works like any other terminal. 


/dev/console 


SEE ALSO 
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ttyld(4), reboot(8) 
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NAME 
dk — Datakit interface 


DESCRIPTION 
A Datakit node consists of a fast digital switch and a number of line modules. Line modules are interfaced 
to computers, terminals, other digital devices. Certain line modules, referred to as trunks, connect Datakit 
nodes together. Each module may communicate with other modules through the switch on up to 510 logi- 
cal channels. 


The directory /dev/dk consists of character special files, each one associated with a logical channel. 
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NAME 
drum — paging device 

SYNOPSIS 
This file refers to the paging device in use by the system. This may actually be a subdevice of one of the 
disk drivers, but in a system with paging spread across multiple disk drives or interleaved will be an indi- 
rect driver. 


FILES 
/dev/drum 


BUGS 
Reads from the drum are not allowed across the interleaving boundaries. Since these only occur every 
.SMbytes or so, and since the system never allocates blocks across the boundary, this is usually not a prob- 
lem. 
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NAME 
fd, stdin, stdout, stderr, tty — file descriptor files 


DESCRIPTION 
These files, conventionally called /dev/fd/0, /dev/fd/1, ... /dev/fd/127, refer to files accessible through file 
descriptors. If file descriptor n is open, these two system calls have the same effect: 
fd = open("/dev/fd/n", mode); 
fd = dup(7 ); 
Creat(2) is equivalent to open, and mode is ignored. As with dup, subsequent IO on fd fails unless the 
original file descriptor allows the read or write operation. 


Entry /dev/fd/3 is conventionally the ‘control terminal’ of the process group to which the present process 
belongs; see stream(A4). 


The entries /dev/stdin, /dev/stdout, /dev/stderr, and /dev/tty are conventionally linked to /dev/fd/0, /dev/fd/1, 
/dev/fd/2, and /dev/fd/3 respectively. 


SEE ALSO 
open(2), dup(2), stream(4) 


DIAGNOSTICS 
Open returns —1 if the related file descriptor is not open. 


Page | 


MEM (4) Eighth Edition MEM(4) 


NAME 
mem, kmem, kmemr, kUmem, mtpr — main memory 


DESCRIPTION 
Mem is a special file that is an image of the main memory of the computer. It may be used, for example, to 
examine (and even to patch) the system. 


Byte addresses in mem are interpreted as physical memory addresses. References to non-existent locations 
cause errors to be returned. 


The files kmem, kmemr, and kUmem are the same as mem except that kernel virtual memory rather than 
physical memory is accessed. Kmemr is read-only, and excludes system buffer pools and device addresses; 
it is intended as a ‘‘safe’’ and ‘“secure’’ mechanism for accessing system tables. KUmem guarantees that 
reads and writes will be done in two-byte quantities; this is convenient for UNIBUS accesses. 


On the VAX, mtpr accesses internal processor registers. Registers are 4 bytes long; register n may be read 
or written at address n*4. 


FILES 
/dev/mem, /dev/kmem, /dev/kmemr, /dev/kUmem, /dev/mtpr 


BUGS 
On PDP11’s and VAX’s, memory files are accessed one byte at a time, an inappropiate method for some 
device registers. 


Examining and patching device and processor registers is likely to lead to unexpected results when read- 
only or write-only bits are present. 


An attempt to read a nonexistent processor register returns 0 instead of an error. 
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NAME 


mesg, rmesg — message line discipline modules 


SYNOPSIS 


#include <sys/stream.h> 


DESCRIPTION 


After the mesg Id line discipline module has been pushed on a stream (see stream(4)), all data and control 
blocks appearing on the stream are turned into structured messages to be read by the user process, and 
information written on the stream is interpreted as messages in the same format. The rmesg Id line disci- 
pline is exactly the opposite: writes, and control operations, on the stream are turned into data messages, 
and arriving data messages are turned into controls. 


Messages written on a stream are interpreted as containing a header of the form 


struct { 
short type; 
short SiZe; 
}s 
followed by the contents of the message. The size is the size of the message exclusive of header. It is lim- 
ited, but to a large number (at least 4KB). Messages may be written piecemeal, and several messages may 
be written at once, but messages will be read at most one at a time. If an impossible message is written, the 
stream is shut down. 


These message types are possible: 
M DATA (0) Ordinary data. 
M BREAK (01) A line break on an RS232-style asynchronous connection. No associated data. 


M _HANGUP 
(02) When received, indicates that the other side has gone away. It is interpreted by the mes- 
sage processor as well as transmitted, and after it is read the stream is useless. No associated 
data. 


M_DELIM — (03) A delimiter that introduces a record boundary in the data. No associated data. 


M IOCTL (06) An ioctl(4) request. The associated data is an integer containing the ioctl code, followed 
by the object passed with the ioctl call that generated the message. It is mandatory to reply 
with M_IOCACK or M_IOCNAK. 


M DELAY (07) A real-time delay. One byte of data, giving the number of sixtieths (fiftieths) of a sec- 
ond delay time. 


M CTL (010) Device-specific control message. 
M_ SIGNAL (0101) Generate signal number given in the 1-byte message. 
M_ FLUSH § (0102) Flush input and output queue if possible. 


M_ STOP (0103) Stop transmission immediately (used, for example, in conjunction with XON-XOFF 
flow control. 


M_ START (0104) Restart transmission after M_STOP. 


M_IOCACK (0105) Positive acknowledgement of M_JOCTL message. At the other end, any included 
data will be stored through the pointer given in the ioctl call. 


M_ IOCNAK (0106) Negative acknowledgement of M_JOCTL. A 1-byte message, if present, will be used 
as the return code for the failing ioctl. 


M CLOSE = (0107) Used internally in Datakit call supervision. 


SEE ALSO 
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stream(4) 
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BUGS 
The format of arguments to M_IJOCTL is machine dependent. Sufficient unto the day is the nonportability 
thereof. 
If incorrectly formatted data is written to mesg, the stream may be irretrievably clogged. 


Page 2 


MT(4) Eighth Edition MT(4) 


NAME 
mt — magtape interface 


SYNOPSIS 
#include <sys/mtio.h> 


DESCRIPTION 
The files mt* refer to magnetic tape drives. Filenames beginning with mt are rewound when closed; those 
beginning with nmt are not. When a file open for writing is closed, two end-of-files are written. If the tape 
is not to be rewound, it is positioned with the head between the two tapemarks. 


The remainder of the filename is made up of the tape drive unit number, and one of Imh indicating a den- 
sity of 800, 1600, or 6250 bpi. Hence mt0/ is unit 0 at 800 bpi, m#2h is unit 2 at 6250. 


A standard tape consists of a series of 1024 byte records terminated by an end-of-file. To the extent possi- 
ble, the system makes it possible, if inefficient, to treat the tape like any other file. Seeks have their usual 
meaning and it is possible to read or write a byte at a time. Writing in very small units is inadvisable, how- 
ever, because it tends to create monstrous record gaps. 


The mt files discussed above are useful when it is desired to access the tape in a way compatible with ordi- 
nary files. When foreign tapes are to be dealt with, and especially when long records are to be read or writ- 
ten, the ‘raw’ interface is appropriate. The associated files have names beginning with rmt or nrmt. 


Each read or write call reads or writes the next record on the tape. In the write case the record has the same 
length as the buffer given. During a read, the record size is passed back as the number of bytes read, pro- 
vided it is no greater than the buffer size; if the record is long, an error is indicated. In raw tape I/O, the 
buffer must begin on a word boundary and the count must be even. Seeks are ignored. A zero byte count is 
returned when a tape mark is read, but another read will fetch the first record of the new tape file. 


Toctl(2) calls perform special operations. The major operations are 
MTIOCTOP doa mag tape operation from the following list, expressed in the structure 


struct mtop_ { 
short = mt_op; /* operation */ 
daddr_t mt_count, /* repeat count */ 
}s 
MTWEO _ write an end-of-file record 
MTFS forward space file 
MTBSF backward space file 
MTFSR ___ forward space record 
MTBSR backward space record 
MTREW rewind 
MTOFFL rewind and put the drive offline 
MTNOP no operation, sets status only 


MTIOCGET _ get mag tape status; see <sys/mtio.h> for details 
MTIOCIEOT ignore EOT error 
MTIOCEEOT enable EOT error 


FILES 

/dev/mt?, /dev/rmt? 
SEE ALSO 

tape(1) 
BUGS 


If any non-data error is encountered, it refuses to do anything more until closed. 


In raw I/O, there should be a way to perform forward and backward record and file spacing and to write an 
EOF mark. 


Page | 


MT(4) Eighth Edition MT(4) 


Files with names like rmt2 may exist as well; their meaning is non-obvious, and their use is discouraged. 
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NAME 
null — data sink 


DESCRIPTION 
Data written on a null special file is discarded. 


Reads from a null special file always return 0 bytes. 


FILES 
/dev/null 
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NAME 


/proc — process file system 


SYNOPSIS 


#include <sys/proc.h> 
#include <sys/pioctl.h> 


DESCRIPTION 
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Proc is a file-system mount point that provides access to the image of each running process in the system. 
The name of each entry in the /proc directory is a five-digit decimal number corresponding to the process 
id. The owner of each ‘file’ is determined by the process’s user-id; only the owner is granted access per- 
missions (and only if the process’ text file is readable). The size of a file is the total virtual memory size of 
the process. 


The standard system-call interface is used to access proc. Open(2) and close(2) behave as usual. The 
object process is unaffected, except that setuid bits will be ignored if an opened process exec’s. (Setuid bits 
are also ignored if the exec’ ing process has traced signals, or stops on exec; see the description of PIOCS- 
MASK and PIOCSEXEC below.) Data may be transferred from or to any locations in the object’s address 
space through Iseek(2), read(2), and write(2). The text segment begins at virtual address 0; the data 
segment starts above the text. The user area extends downward below virtual address 0x80000000, and is 
UPAGES*NBPG bytes long; the stack segment grows downward below the user area. Between the end of 
the data and the beginning of the stack lies no-man’s land. The text, data, and stack sizes may be deter- 
mined from the process’ proc structure (see below). There are two differences from reading and writing 
ordinary files: (1) no i/o transfer may span a segment boundary; (2) the user area is writable only in the 
locations of saved user registers. 


Several process control actions are available through an ioctl(2) of the form 822623.sp48u 
union { struct proc p; long i; } buffer; 
retval = ioctl(fildes, code, &buffer); 


The possible codes are as follows: 


PIOCGETPR copies the object’s proc structure from the kernel process table into buffer.p. Since this 
information resides in system space, it is not accessible via a normal read. 


PIOCSTOP _ sends the signal SIGSTOP to the object, and waits for it to enter the stopped state. 
PIOCWSTOP simply waits for the object to stop. 
PIOCRUN makes the object runnable again after a stop. 


PIOCSMASK defines (via the bit mask buffer.i) a set of signals to be traced; i.e., the arrival of such a sig- 
nal will cause the object to stop. (The signal numbered v is specified by the bit 1<<(n—-1).) 
A mask of zeroes turns off the trace. The traced state and mask bits are inherited by the 
child of a fork(2). When the object is closed, the mask bits are lost, but the traced state is 
retained for side effects. 

PIOCSEXEC causes the object to stop after exec’ing. This condition is inherited by children and is 
retained when the object is closed. 


PIOCREXEC reverses the effect of PIOCSEXEC. 
PIOCCSIG clears the object’s currently pending signal (if any). 
PIOCKILL _ sends a signal to the process. 


PIOCOPENT provides, in retval, a read-only file descriptor for the object process’ text file. This allows a 
debugger to find the symbol table without having to know any path names. 


PIOCNICE _ increments the object’s nice(2) priority by the amount buffer.i. Only the super user may bet- 
ter a process’ priority in this way, but any user may make the priority worse. 


All system calls are interruptible by signals, so that, for example, an alarm(2) may be set to avoid waiting 
forever for a process that may never stop. Any system call is guaranteed to be atomic with respect to the 
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FILES 


object, but, as with ordinary files, there is nothing to prevent more than one process from trying to control 
the same object. 


The following header files are useful in analyzing proc files: 


<signal.h> list of signal numbers 

<sys/param.h> size parameters (e.g., UPAGES, NBPG) 
<sys/types.h> — special system types 

<sys/user.h> user structure 

<sys/proc.h> _ proc structure 

<sys/reg.h> locations of saved user registers 
<sys/pioctLh> ioctl codes 


As with any file system, /proc must be mounted in order to be used. The mount point should be an empty 
directory created with mode 0555; /etc/procmount should then be run at boot time. (The file system can be 
unmounted by ‘/etc/procmount —u’.) 


/proc directory (list of active processes) 
/proc/nnnnn process image 


SEE ALSO 


ps(1), hang(1), signal(2), pi(9.1) 


DIAGNOSTICS 


BUGS 


This is a list of errors which can occur in addition to the errors normally associated with the file system; see 
intro(2): 


ENOENT is returned if the object process has exited after being opened. 
EIO is returned if I/O is attempted at an illegal address in the object. 


EBUSY _ is returned if the object is in the midst of changing virtual memory attributes, or has pages 
locked for physical I/O. 


ENOSPC is returned if a write is attempted on a shared text segment, but there is no room on the swap 
space to make a copy. 


EPERM is returned if someone other than the super user attempts to better a process’ priority by issuing a 
PIOCNICE. 


A process must be swapped in for reading and writing (but not ioctl); this consumes minimal system 
resources, but may involve a noticeable delay. 


The spectrum of states which result in the EBUSY error is too conservative. 


A process loaded from a text file with magic number 0407 does not have a read-only text segment; in this 
(presumably rare) case PLOCOPENT does not work, and the process is accessible even if the text file is 
read-only. 
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Eighth Edition PT(4) 


pt — interprocess I/O junctor files 


DESCRIPTION 


These special files, conventionally collected in directory /dev/pt, provide a facility for interprocess commu- 
nication. The name ‘pt’ comes from ‘pseudo-tty,’ after vaguely similar mechanisms in other systems. 


Pt files come in even-odd pairs. If one process opens an odd numbered pt file, and another opens the corre- 
sponding even file, then data written on one file is available for reading on its partner, in symmetrical full- 
duplex fashion. ‘Record’ boundaries are preserved, where a record is the information presented in one 
write call. Thus a reader attempting to read into a large buffer will receive chunks of data corresponding to 
the amounts generated by each call to write. 


The odd-numbered member of a pair is the master. Masters and slaves differ only in the rules for opening; 
IO is symmetrical. Master pt files may be opened by at most one process. Thus the following strategy is 
appropriate for establishing communications: one process searches the /dev/pt directory for an odd- 
numbered file it can open; when it finds one, it publishes the name in some way. Typically, it will either 
fork off a child process that knows the name by sharing variables, or place the name in some conventional 
place. Then one or more slave processes may open the corresponding even-numbered file and communi- 
cate with the master. 


Once both even- and odd-numbered members of a pair have been opened, the communications channel is 
shut down when the file on either side is closed for the last time. Thus a master process that expects several 
unrelated processes to open the even pt corresponding to its odd pt should keep the even pt open. 


Pt files are stream devices and line discipline modules (see stream(4)) may be attached to them. 


SEE ALSO 


BUGS 
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stream(4), ptopen(3) 


Writes are not atomic, in general. However, several slow writers may write small messages to a fast reader 
and achieve the illusion of atomicity. 
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NAME 

ra — DEC MSCP disks (RA60, RA80, RA81) 
DESCRIPTION 
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Ra* refer to disk drives conforming to DEC’s Mass Storage Control Protocol standard: drives such as the 
RA81 connected via controllers such as the UDAS5O. Files with minor device numbers 0 through 7 refer to 
various portions of drive 0, minor devices 8 through 16 refer to drive 1, and so on up to 63. These files 
have a blocksize of 1K bytes; if 64 is added to the minor device number, the resulting file has 4K byte 
blocks, and if used as a filesystem, a slightly different structure. 


The range and size of the pseudo-drives for each drive are as follows. Sizes are measured in hardware sec- 
tors (512 bytes). 


disk start length 
0 0 10240 
1 10240 20480 
2 30720 =.249848 
3 280568 249848 
4 530416 249848 
5 780264 110808 
6 30720 749544 


7 0 arbitrarily large 
Partition 7 covers the entire disk: 891072 sectors on an RA81. 


The ra files discussed above access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a ‘raw’ interface which provides for 
direct transmission between the disk and the user’s read or write buffer. A single read or write call results 
in exactly one I/O operation and therefore raw I/O is considerably more efficient when many words are 
transmitted. The names of the raw RA files begin with rra and end with a number which selects the same 
disk as the corresponding ra file. 


In raw I/O the buffer must begin on a word boundary, and counts should be a multiple of 512 bytes (a disk 
block). Likewise /seek(2) calls should specify a multiple of 512 bytes. 


Several ioctl(2) calls apply to the raw devices. They are probably useful only for bad block handling. 


UIOCHAR The third argument to ioctl is a pointer to a struct ud_unit: 
struct ud_unit { 
daddr_t radsize; /* size of the disk */ 
daddr_t rctsize; /* size of the RCT, including pad */ 


long medium; 
short tracksz; 
short groupsz; 
short cylsz; 
char rbns; 
char copies; 
}s 
which the system fills with geometry parameters for the drive. 
UIORRCT The third argument points to a struct ud_rctbuf: 
struct ud_rctbuf { 
caddr_t buf; 
int Ibn; 
}s 
Buf points to a 512-byte buffer, into which block /bn of the replacement and caching table 
(RCT) is read. As many copies of the RCT as necessary are examined to find a readable 
copy of the block. 
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UIOWRCT The third argument points to a struct ud_rctbuf; block [bn of the RCT is written in all 
copies. 
UIOREPL The third argument points to a struct ud_repl : 
struct ud_repl { 
daddr_t replbn; /* good block */ 
daddr_t Ibn; /* bad block */ 
short prim; /* nonzero if primary replacement */ 
}s 
A REPLACE command is sent to the controller, requesting that attempts to access logical 
block /bn henceforth be revectored to replacement block replbn. Prim should be set 
nonzero if and only if rep/bn is the primary replacement block for /bn. 
FILES 
/dev/ra*, /dev/rra* 
SEE ALSO 
rarepl(8) 
MSCP Basic Disk Functions Manual 
DEC Standard Disk Format Specification 
BUGS 


In raw I/O read and write(2) truncate file offsets to 512-byte block boundaries, and write scribbles on the 
tail of incomplete blocks. Thus, in programs that are likely to access raw devices, read, write and Iseek(2) 
should always deal in 512-byte multiples. 


UIORRCT and UIOWRCT will misbehave if invoked on a partition that doesn’t start at the beginning of 
the disk. Partition 7 (the whole disk) is the best choice. 


This driver should be split into a generic disk driver and a port driver, which communicate by exchanging 
MSCP packets. 
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Eighth Edition RK(4) 


tk — RK11/RKO7 disk driver 


DESCRIPTION 


FILES 


BUGS 
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Files with minor device numbers 0 through 7 refer to various portions of drive 0, minor devices 8 through 
16 refer to drive 1, etc. 


The range and size of the pseudo-drives for each drive are as follows: 


RKO7 partitions: 
disk start length 
0 0 15884 
1 15906 =: 10032 
2 0 53780 
3 0 0 
4 0 0 
5 0 0 
6 26004 27786 
7 0 0 


On a dual RKO7 system partition 0 is used for the root for one drive and partition 6 for the /usr file system. 
If large jobs are to be run, partition 1 on both drives provides a 10Mbyte paging area. Otherwise partition 2 
on the other drive is used as a single large file system. 


The rk files discussed above access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a ‘raw’ interface which provides for 
direct transmission between the disk and the user’s read or write buffer. A single read or write call results 
in exactly one I/O operation and therefore raw I/O is considerably more efficient when many words are 
transmitted. The names of the raw RK files begin with rrk and end with a number which selects the same 
disk as the corresponding rk file. 


In raw I/O the buffer must begin on a word boundary, and counts should be a multiple of 512 bytes (a disk 
block). Likewise /seek(2) calls should specify a multiple of 512 bytes. 


/dev/rk?, /dev/trk? 


In raw I/O read and write (2) truncate file offsets to 512-byte block boundaries, and write scribbles on the 
tail of incomplete blocks. Thus, in programs that are likely to access raw devices, read, write and Iseek(2) 
should always deal in 512-byte multiples. 
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NAME 


stream — stream I/O control calls 


SYNOPSIS 


#include <sys/ioctl.h> 
ioctl(fd, code, param) 
union universe *param; 


DESCRIPTION 
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A stream is a connection between two processes, or between a process and a device. It is referred to by a 
file descriptor, and ordinary read and write calls apply. When a write(2) call is given on a stream whose 
other end has disappeared, for example because the process at other end of a pipe has terminated, or a 
device has hung up, a SIGPIPE signal is generated; if the signal is ignored, the write call returns error 
EPIPE. The first several (currently 64) read(2) calls on such a disconnected streams return 0; subsequent 
calls generate SIGPIPE signals. 


Processing modules may be inserted into streams. These ioctl calls insert, delete, inspect, and perform 
operations for stream IO modules. They apply to the file descriptor of any open stream object: terminal, 
network connection, pipe. The param argument is a general pointer which, for these calls, is usually null or 
a pointer to int. The codes are 


FIOPUSHLD 
inserts, at the near end of the stream, the line discipline named by the integer to which param 
points. A census of line discipline modules is given below. 


FIOINSLD 
inserts a named line discipline at a given level in a stack of such modules on the stream. Param 
points to a structure containing two short integers respectively naming the line discipline and the 
level. A level of 0 could be accomplished by FIOPUSHLD. This call is under construction and 
may not be available yet. 


FIOPOPLD 
pops (removes) the nearest line discipline module, if param is null. If it points to an integer, the 
line discipline at that level is removed. The integer 0 corresponds to a null param, and (as with 
FIOINSLD) the non-null case may not be handled yet. 


FIOLOOKLD 
returns the number of the topmost line discipline in the stack. If param is not null but instead 
points to an integer, the line discipline at that level is returned in the same integer. As with push 
and pop, the non-null case may not be handled yet. 


FIOSNDFD 
sends the integer file descriptor pointed to by param to the process on the other end of the pipe 
whose file descriptor is fd. 


FIORCVFD 
delivers a structure pointed to by param: 


struct passfd { 


union { 
int fd; 
} f; 
short uid; 
short gid; 
short nice; 
short fill; 
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The call blocks until there is something in the stream. If data is present, it returns EJO. If the 
FIOSNDED call has sent a file descriptor to the other end of the pipe, this call fills in the user 
and group ID of the sending process, its niceness (priority), and a file descriptor for the file being 
sent; this file is now open in the calling process. 


FIONREAD 
stores, in the integer pointed to by param, the number of characters that may be read from this 
stream without possible blocking. 


TIOCSPGRP 
with null param makes this process the head of a process group and makes this stream its control 
stream. When signals, such as hangup, interrupt, and quit, arrive at a control stream, they are 
sent to its process group. Child processes inherit the process group of their parent. Process 
groups are created only by explicit use of this call, and not implicitly by opening certain devices. 
If param is not null, it points to an integer nominating a process group to receive signals from 
this stream. 


TIOCGPGRP 
stores through param an integer naming the process group associated with the stream. 


TIOCEXCL 
marks this stream as inaccessible except by the super-user or by processes in the group associ- 
ated with this stream. 


TIOCNXCL 
removes the inaccessibility of the stream. 


TIOCSBRK 
generates a message requesting a line break. The message is understood by devices capable of 
generating it (such as asynchronous character devices) and ignored otherwise. 


TIOCFLUSH 
generates a message causing downstream modules to throw away any queued characters, if pos- 
sible. It applies to both input and output queues. 


Here is a list of available line discipline modules. The magic numbers are collected in the standard library, 
and are accessible under the following names: 


tty Id Terminal processing according to standard Seventh Edition rules; see ttyld(4). 


ntty Id Terminal processing according to (modified) Berkeley ‘new tty’ rules; see Berkeley Users Man- 
ual. 


cdkp Id Character-mode Datakit URP protocol. 

dkp Id_ Block-mode Datakit URP protocol. 

rdk Id = Special Datakit protocol used in connection setup. 
pk Id Packet-driver protocol (obsolete). 

buf Id Buffering mechanism; see bufld(4). 


mesg Id, rmesg Id 
Mesg Id turns stream control blocks arriving in the read direction into data messages, and writ- 
ten messages into controls. rmesg Id does the opposite. See mesg (4). 


tre _Id Helps debug stream line discipline modules. 
conn _Id_ For making unique connections to servers. See connld(A4). 


ip Id, tcp Id, udp Id, arp Id 
Internet protocols; see inet(3). 


Page 2 


STREAM (4) Eighth Edition STREAM(4) 


SEE ALSO 
ioctl(2) 
D. M. Ritchie, ‘A Stream I/O System’ BLTJ, October, 1984 


DIAGNOSTICS 
—1 is returned for errors. 
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NAME 


ttyld — terminal processing 


SYNOPSIS 


#include <sgtty.h> 


DESCRIPTION 
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This processing module is usually inserted into a stream(4) connected to a terminal device. It gathers input 
into lines, performs erase and kill processing, and translates control sequences. 


Certain special characters have particular meaning on input. These characters are not passed to a program 
except in raw mode, where they lose their special character. It is possible to change these characters from 
the default. 


# erases the last-typed character. It will not erase beyond the beginning of a line or an EOT. 
@ erases the entire preceding part of the line, but not beyond an EOT. 


EOT —_(Control-D) may be used to generate an end of file from a terminal. When an EOT is received, all 
the characters waiting to be read are immediately passed to the program, without waiting for a 
new-line, and the EOT is discarded. Thus if there are no characters waiting, which is to say the 
EOT occurred at the beginning of a line, zero characters will be passed back, and this is the stan- 
dard end-of-file indication. 


\ escapes a following erase, kill, or EOT character and allows it to be treated as ordinary data. 


DEL is not passed to a program but generates the interrupt signal (2). The signal is sent to any pro- 
cesses in the process group of the stream; see stream(A4). 


FS generates the quit signal (3). 
DC3 delays all printing on the terminal until something is typed in. 
DC1 restarts printing after DC3 without generating any input to a program. 


Several ioctl(2) calls apply to terminals. Most of them use the following structure, defined in <sgtty.h>: 


struct sgttyb { 
char sg_ispeed; 


char sg_ospeed; 
char sg_ erase; 
char sg_kill; 


int sg flags; 
}s 
The sg_ispeed and sg_ospeed fields describe the input and output speeds of the device according to the fol- 


lowing table. They are not interpreted by the tty line discipline, but merely passed on to the device. 
Devices ignore impossible speed changes. Symbolic values in the table are as defined in <sgtty.h>. 


BO 0 (hang up device) 


B50 1 50 baud 
B75 2 75 baud 
B110 3 110 baud 
B134 4 134.5 baud 
BI50 5 150 baud 
B200 6 200 baud 
B300 7 300 baud 
B600 8 600 baud 
B1200 9 1200 baud 
B1800 10 1800 baud 
B2400 11 2400 baud 
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B4800 12 4800 baud 
B9600 13 9600 baud 
EXTA 14 External A 
EXTB 15 External B 


The sg erase and sg _ kill fields of the argument structure specify the erase and kill characters respectively. 
(Defaults are # and @.) 


The sg _flags field of the argument structure contains several bits that determine the system’s treatment of 
the terminal: 


ALLDELAY 0177400 Delay algorithm selection 
VTDELAY 0040000 Select form-feed and vertical-tab delays: 


FFO 0 

FF1 0100000 

CRDELAY 0030000 Select carriage-return delays: 
CRO 0 

CRI 0010000 

CR2 0020000 

CR3 0030000 

TBDELAY 0006000 Select tab delays: 
TABO 0 

TABI 0001000 

TAB2 0004000 


XTABS 0006000 
NLDELAY 0001400 Select new-line delays: 


NLO 0 

NLI 0000400 

NL2 0001000 

NL3 0001400 

EVENP 0000200 Even parity allowed on input (most terminals) 
ODDP 0000100 Odd parity allowed on input 

RAW 0000040 Raw mode: wake up on all characters, 8-bit interface 
CRMOD 0000020 Map CR into LF; echo LF or CR as CR-LF 

ECHO 0000010 Echo (full duplex) 


LCASE 0000004 Map upper case to lower on input 
CBREAK — 0000002 Return each character as soon as typed 
TANDEM —= 0000001 Automatic flow control 


The delay bits specify how long transmission stops to allow for mechanical or other movement when cer- 
tain characters are sent to the terminal. In all cases a value of 0 indicates no delay. 


If a form-feed/vertical tab delay is specified, it lasts for about 2 seconds. 


Carriage-return delay type 1 lasts about .08 seconds. Delay type 2 lasts about .16 seconds. Delay type 3 is 
supposed to be for the Concept 100. 


New-line delay type | is supposed to be for the Teletype model 37. Type 2 is about .10 seconds. Type 3 is 
unimplemented and is 0. 


Tab delay type | is supposed to be for the Teletype model 37. Type 3, called XTABS, is not a delay at all 
but causes tabs to be replaced by the appropriate number of spaces on output. 


In raw mode, every character is passed immediately to the program without waiting until a full line has 
been typed. No erase or kill processing is done; the end-of-file indicator (EOT), the interrupt character 
(DEL) and the quit character (FS) are not treated specially. There are no delays and no echoing, and no 
replacement of one character for another; characters are a full 8 bits for both input and output. 
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Mode 020 causes input carriage returns to be turned into new-lines; input of either CR or LF causes LF-CR 
both to be echoed (for terminals without a new-line function). 


CBREAK is a sort of half-cooked mode. Programs read each character as soon as typed, instead of waiting 
for a full line, but quit and interrupt work, and output delays CRMOD, XTABS, ECHO, and parity work 
normally. On the other hand there is no erase or kill, and no special treatment of \ or EOT. 


TANDEM mode causes the system to produce a stop character (default DC3) whenever the input queue is 
in danger of overflowing, and a start character (default DC1) when the input queue has drained sufficiently. 
It is useful for flow control when the ‘terminal’ is actually another machine that obeys the conventions. 


Several ioctl calls have the form: 


#include <sgtty.h> 


ioctl(fildes, code, arg) 
struct sgttyb *arg; 


The applicable codes are: 


TIOCGETP 
Fetch the parameters associated with the terminal, and store in the pointed-to structure. 


TIOCSETP, TIOCSETN 
Set the parameters according to the pointed-to structure. These (equivalent) codes are syn- 
chronous with output data. 


The following codes affect characters that are special to the terminal interface. The argument is a pointer to 
the following structure, defined in <sgtty.h>: 


struct tchars { 
char t_intre /* interrupt */ 
char t_quitc; /* quit */ 
char  t_startc; /* start output */ 
char __t_stopc; /* stop output */ 
char t_eofc; /* end-of-file */ 
char t_brkc; /* input delimiter (like nl) */ 
}; 
The default values for these characters are DEL, FS, DC1, DC3, EOT, and -1. A character value of —1 
eliminates the effect of that character. The t_brkc character, by default —1, acts like a new-line in that it ter- 
minates a ‘line,’ is echoed, and is passed to the program. The ‘stop’ and ‘start’ characters may be the same, 
to produce a toggle effect. It is counterproductive to make other special characters (including erase and 
kill) identical. 


TIOCSETC 
Change the various special characters to those given in the structure. 


TIOCGETC 
Fill in the structure with the current special characters. 


SEE ALSO 


Page 3 


getty(8), stty(1), signal(2), ioctl(2), stream(4) 
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NAME 


acct — execution accounting file 


SYNOPSIS 


#include <sys/acct.h> 


DESCRIPTION 


Acct(2) causes entries to be made into an accounting file for each process that terminates. The accounting 
file is a sequence of entries whose layout, as defined by the include file is: 
/* 
* Accounting structures; 
* these use a comp _t type which is a 3 bits base 8 
* exponent, 13 bit fraction ‘‘floating point’’ number. 
**/ 
typedef u_short comp t; 


struct acct 


{ 


char ac_comm[10]; /* Accounting command name */ 
comp t ac_utime; /* Accounting user time */ 
comp t ac_stime; /* Accounting system time */ 
comp t ac_etime; /* Accounting elapsed time */ 
time_t ac_btime; /* Beginning time */ 
short ac_uid; /* Accounting user ID */ 
short ac_ gid; /* Accounting group ID */ 
short ac_mem,; /* average memory usage */ 
comp t ac_io; /* number of disk IO blocks */ 
dev t ac _tty; /* control typewriter */ 
char ac_flag; /* Accounting flag */ 
}s 
#define AFORK 01 /* has executed fork, but no exec */ 
#define ASU 02 /* used super-user privileges */ 
#define ASTINY 04 /* done a tiny read from the disk */ 


If the process does an exec(2), the first 10 characters of the filename appear in ac_comm. The accounting 
flag contains bits indicating whether exec(2) was ever accomplished, and whether the process ever had 
super-user privileges. 


SEE ALSO 


Page | 


acct(2), sa(8) 
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NAME 


a.out — assembler and link editor output 


SYNOPSIS 


#include <a.out.h> 


DESCRIPTION 
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A.out is the output file of the assembler as(1) and the link editor /Jd(1). Both programs make a.out exe- 
cutable if there were no errors and no unresolved external references. The layout as given in the include file 
is: 


/* 
* Header prepended to each a.out file. 
**/ 
struct exec { 
long a_magic; /* magic number */ 
unsigned a_text; /* size of text segment */ 
unsigned a data; /* size of initialized data */ 
unsigned a_bss; __/* size of uninitialized data */ 
unsigned a_syms; /* size of symbol table */ 
unsigned a_entry; /* entry point */ 
unsigned a _trsize; /* size of text relocation */ 
unsigned a_drsize; /* size of data relocation */ 
}s 


#define OMAGIC0407 /* old impure format */ 
#define NMAGIC0410 /* read-only text */ 
#define ZMAGIC 0413 /* demand load format */ 


/* 
* Macros which take exec structures as arguments and tell whether 
* the file has a reasonable magic number or offsets to text | symbols | strings. 
*/ 
#define N BADMAG(x) \ 
(((x).a_magic)!=OMAGIC && ((x).a_magic)!=NMAGIC && ((x).a_magic)!=ZMAGIC) 


#define N_TXTOFF(x) \ 

((x).a_magic==ZMAGIC ? 1024 : sizeof (struct exec)) 
#define N_ SYMOFF(x) \ 

(N_TXTOFF(x) + (x).a_text+(x).a_data + (x).a_trsize+(x).a_drsize) 
#define N_STROFF(x) \ 

(N_SYMOFF(x) + (x).a_syms) 


The file has five sections: a header, the program text and data, relocation information, a symbol table and a 
string table (in that order). The last three may be omitted if the program was loaded with the ‘-s’ option of 
Id or if the symbols and relocation have been removed by strip (1). 


In the header the sizes of each section are given in bytes. The size of the header is not included in any of 
the other sizes. 


When an a.out file is executed, three logical segments are set up: the text segment, the data segment (with 
uninitialized data, which starts off as all 0, following initialized), and a stack. The text segment begins at 0 
in the core image; the header is not loaded. If the magic number in the header is OMAGIC (0407), it indi- 
cates that the text segment is not to be write-protected and shared, so the data segment is immediately con- 
tiguous with the text segment. This is the oldest kind of executable program and is rarely used. If the 
magic number is NMAGIC (0410) or ZMAGIC (0413), the data segment begins at the first 0 mod 1024 
byte boundary following the text segment, and the text segment is not writable by the program; if other 
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processes are executing the same file, they will share the text segment. For ZMAGIC format, the text seg- 
ment begins at a 0 mod 1024 byte boundary in the a.out file, the remaining bytes after the header in the first 
block are reserved and should be zero. In this case the text and data sizes must both be multiples of 1024 
bytes, and the pages of the file will be brought into the running image as needed, and not pre-loaded as with 
the other formats. This is especially suitable for very large programs and is the default format produced by 
Id(1). 


The stack will occupy the highest possible locations in the core image: growing downwards from 
Ox7ffff400. The stack is automatically extended as required. The data segment is only extended as 
requested by break(2). 


After the header in the file follow the text, data, text relocation data relocation, symbol table and string table 
in that order. The text begins at the byte 1024 in the file for ZMAGIC format or just after the header for the 
other formats. The N_TXTOFF macro returns this absolute file position when given the name of an exec 
structure as argument. The data segment is contiguous with the text and immediately followed by the text 
relocation and then the data relocation information. The symbol table follows all this; its position is com- 
puted by the N SYMOFF macro. Finally, the string table immediately follows the symbol table at a posi- 
tion which can be gotten easily using N STROFF. The first 4 bytes of the string table are not used for 
string storage, but rather contain the size of the string table; this size INCLUDES the 4 bytes, the minimum 
string table size is thus 4. 


The layout of a symbol table entry and the principal flag values that distinguish symbol types are given in 
the include file as follows: 


/* 
* Format of a symbol table entry. 
**/ 
struct nlist { 
union { 
char *n_name; /* for use when in-core */ 
long n_strx; //* index into file string table */ 
} n_un; 
unsigned char n_ type; /* type flag, i.e. N TEXT etc; see below */ 
char n_ other; 
short n_desc; /* see <stab.h> */ 
unsigned n_value; /* value of this symbol (or sdb offset) */ 
}s 
#define n_hash n_desc  /* used internally by Id */ 
/* 
* Simple values for n_type. 
**/ 
#define N_UNDF 0x0 /* undefined */ 
#define N_ABS Ox2 /* absolute */ 


#define N TEXT Ox4 /* text */ 
#define N DATA 0x6 /* data */ 


#define N_BSS Ox8 /* bss */ 

#define N COMM 0x12 /* common (internal to 1d) */ 
#define N_FN Oxf /* file name symbol */ 
#define N EXT 01 /* external bit, or’ed in */ 


#define N_TYPE Oxle /* mask for all the type bits */ 
/* 


* Other permanent symbol table entries have some of the N_STAB bits set. 
* These are given in <stab.h> 
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*/ 
#define N_ STAB Oxe0 /* if any of these bits set, don’t discard */ 


/* 
* Format for namelist values. 
*/ 
#define N FORMAT "%08x" 


In the a.out file a symbol’s n_un.n_strx field gives an index into the string table. A n_strx value of 0 indi- 
cates that no name is associated with a particular symbol table entry. The field n_un.n_name can be used to 
refer to the symbol name only if the program sets this up using n_strx and appropriate data from the string 
table. 


If a symbol’s type is undefined external, and the value field is non-zero, the symbol is interpreted by the 
loader /d as the name of a common region whose size is indicated by the value of the symbol. 


The value of a byte in the text or data which is not a portion of a reference to an undefined external symbol 
is exactly that value which will appear in memory when the file is executed. If a byte in the text or data 
involves a reference to an undefined external symbol, as indicated by the relocation information, then the 
value stored in the file is an offset from the associated external symbol. When the file is processed by the 
link editor and the external symbol becomes defined, the value of the symbol will be added to the bytes in 
the file. 


If relocation information is present, it amounts to eight bytes per relocatable datum as in the following 
structure: 


/* 
* Format of a relocation datum. 
*/ 
struct relocation_info { 
int r_address; /* address which is relocated */ 
unsigned r_symbolnum:24, /* local symbol ordinal */ 
r_perel:1, /* was relocated pc relative already */ 
r_length:2, /* O=byte, 1=word, 2=long */ 
r_extern:1, /* does not include value of sym referenced */ 
4; /* nothing, yet */ 
}s 


There is no relocation information if a_trsize+a_drsize==0. If r_extern is 0, then r_symbolnum is actually a 
n_type for the relocation (i.e. N_TEXT meaning relative to segment text origin.) 


SEE ALSO 


BUGS 
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adb(1), as(1), Id(1), nm(1), sdb(1), stab(5), strip(1) 


Not having the size of the string table in the header is a loss, but expanding the header size would have 
meant stripped executable file incompatibility, and we couldn’t hack this just now. 
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NAME 
ar — archive (library) file format 
SYNOPSIS 
#include <ar.h> 
DESCRIPTION 
The archive command ar is used to combine several files into one. Archives are used mainly as libraries to 
be searched by the link-editor /d. 
A file produced by ar has a magic string at the start, followed by the constituent files, each preceded by a 
file header. The magic number and header layout as described in the include file are: 
#define ARMAG "!<arch>\n" 
#define SARMAG 8 
#define ARFMAG "‘\n" 
struct ar_hdr { 
char ar_name[16]; 
char ar_date[12]; 
char ar_uid[6]; 
char ar_gid[6]; 
char ar_mode[8]; 
char ar_size[10]; 
char ar_fmag[2]; 
}s 
The name is a blank-padded string. The ar_fmag field contains ARFMAG to help verify the presence of a 
header. The other fields are left-adjusted, blank-padded numbers. They are decimal except for ar_mode, 
which is octal. The date is the modification date of the file at the time of its insertion into the archive. 
Each file begins on a even (0 mod 2) boundary; a new-line is inserted between files if necessary. Neverthe- 
less the size given reflects the actual size of the file exclusive of padding. 
There is no provision for empty areas in an archive file. 
The encoding of the header is portable across machines. If an archive contains printable files, the archive 
itself is printable. 
SEE ALSO 
ar(1), Id(1), nm(1) 
BUGS 
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File names lose trailing blanks. Most software dealing with archives takes even an included blank as a 
name terminator. 
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NAME 


config — system configuration template files 


DESCRIPTION 
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These files are used as input by config(8). Except as noted, they are kept in /usr/sys/conf. 


Files names the source files that make up the kernel. Each line consists of a filename (relative to /usr/sys ) 
followed by some magic words. For example: 


sys/acct.c standard 
is a file used by any version of the system; 
dev/uba.c standard device-driver 
is also always used, and contains device register references (which may require special compilation hacks); 
dev/ju.c optional ju device-driver 
is included only if the ju device is expected; 
dev/ttyld.c optional tty pseudo-device 
is included only if the tty pseudo-device is requested. 


Devices describes possible device drivers, file system handlers, and line disciplines; the information is used 
to generate handler dispatch tables. It consists of lines with the following blank-separated fields: 


Type of handler: device for character devices, stream-device for character stream devices, block- 
device for block devices, file-system for file system handlers, line-discipline for line discipline han- 
dlers. If the type is preceded by the word ‘standard’ (e.g. standard block-device), the handler is 
always included; otherwise, it is included only if requested. 


Table index: major device number, filesystem type, or line discipline number. 


Driver name. Used in files and conf. Config writes a header file name.h for each device; if that 
device is configured, NAME is defined to be the number of devices of that type. 


Entry point name. Used as a prefix for data structure and driver entry points. 


Entry points. For block devices, some of open, close, strategy, dump, B_TAPE (the last puts the 
flag B_TAPE in the d_flags entry in the block device switch); for character devices, open, close, 
read, write, ioctl, reset. For stream devices and line disciplines, info should be specified. For file 
system handlers, put, get, free, updat, read, write, trunc, stat, nami, mount, ioctl. 


AS a special case, lines beginning with ‘:’ are copied intact to conf.c. This can be used for hacks like 
: int mem_no = 3;/* major device number of memory special file */ 


Addenda to files and devices specific to a particular machine may be kept in /usr/sys/machine/files and 
/usr/sys/machine/devices. The addenda are treated as if appended to the general files. 
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NAME 
core — format of memory image file 

DESCRIPTION 
UNIX writes out a memory image of a terminated process when any of various errors occur. See signal (2) 
for the list of reasons; the most common are memory violations, illegal instructions, bus errors, and user- 
generated quit signals. The memory image is called ‘core’ and is written in the process’s working directory 
(provided it can be; normal access controls apply). 
The core file consists of the u. area, which currently consists of 6 pages, beginning with a user structure as 
given in /media/acher/Games/v8/usr/include/sys/user.h. The kernel stack grows from the end of this 6 page 
region. The remainder of the core file consists first of the data pages and then the stack pages of the process 
image. 
In general the debugger adb(1) is sufficient to deal with core images. 

SEE ALSO 
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adb(1), pi(9.1), coreid(1) 
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NAME 
cpio — format of cpio archive 


DESCRIPTION 
The header structure, when the -c option of cpio(1) is not used, is: 


typdef unsigned short ushort; 
struct { 
short h_ magic, 
h_dev; 
ushort h_ino, 
h_mode, 
h_uid, 
h_gid; 
short h_nlink, 
h_rdev, 
h_mtime[2], 
h_namesize, 
h_filesize[2]; 
char h_name[h_namesize rounded to word]; 
} Hdr; 


When the —c option is used, the header information is described by: 


sscanf(Chdr,"%60%60%60%60%60%60%60%60% | 110%60% 1 1lo%s", 
&Hdr.h_magic, &Hdr.h_dev, &Hdr.h_ino, &Hdr.h_mode, 
&Hdr.h_uid, &Hdr.h_gid, &Hdr.h_nlink, &Hdr.h_rdev, 
&Longtime, &Hdr.h_namesize,&Longfile,Hdr.h_name); 


Longtime and Longfile are equivalent to Hdr.h_mtime and Hdr.h_filesize, respectively. The contents of 
each file are recorded in an element of the array of varying length structures, archive, together with other 
items describing the file. Every instance of h_magic contains the constant 070707 (octal). The items 
h_dev through h_mtime have meanings explained in stat(2). The length of the null-terminated path name 
h_name, including the null byte, is given by h_namesize. 


The last record of the archive always contains the name TRAILER!!!. Special files, directories, and the 
trailer are recorded with h_filesize equal to zero. 


SEE ALSO 
cpio(1), find(1), stat(2). 
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NAME 
dir — format of directories 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/dir.h> 


DESCRIPTION 
A directory behaves exactly like an ordinary file, save that no user may write into a directory. The fact that 


a file is a directory is indicated by a bit in the flag word of its i-node entry; see filsys(5). The structure of a 
directory entry as given in the include file is: 


#ifndef DIRSIZ 
#define DIRSIZ 14 


#endif 
struct direct 
{ 
ino t d_ino; 
char d_name[DIRSIZ]; 
i 


By convention, the first two entries in each directory are for *.’ and ‘..’. The first is an entry for the direc- 
tory itself. The second is for the parent directory. The meaning of ‘..’ is modified for the root directory of 
the master file system (‘/’), where ‘..’ has the same meaning as ‘.’. 

SEE ALSO 
filsys(5), directory(3) 
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NAME 
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environ — user environment 


SYNOPSIS 


extern char **environ; 


DESCRIPTION 


An array of strings called the ‘environment’ is made available by exec(2) when a process begins. By con- 
vention these strings have either the form ‘name=value’, defining a variable, or ‘name() {value }’, defining 
a function (see sh(1)). The following variables are used by various commands: 


PATH 


HOME 
TERM 


SHELL 


The sequence of directory prefixes that sh, time, nice(1), etc., apply in searching for a file 
known by an incomplete path name. The prefixes are separated by ‘:’. Login(1) sets 
PATH=:/bin:/usr/bin. 


A user’s login directory, set by /ogin(8) from the password file passwd (5). 


The kind of terminal for which output is to be prepared. This information is used by com- 
mands, such as nroff or plot(1), which may exploit special terminal capabilities. See 
/etc/termcap for a list of terminal types. 


The name of the login shell. 


The environment may be queried by getenv(3) or by the set or whatis commands of sh(1). Names may be 
placed in the environment by the export command by and ‘name=value’ arguments in sh(1). Names may 
also be placed in the environment at the point of an exec(2). It is unwise to conflict with certain sh(1) vari- 
ables that are frequently exported by ‘profile’ files: MAIL, PS1, PS2, IFS. 


SEE ALSO 


sh(1), exec(2), getenv(3), term(7) 
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NAME 
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filsys, flblk, ino — format of file system volume 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/fblk.h> 
#include <sys/filsys.h> 
#include <sys/ino.h> 


DESCRIPTION 


Every file system is divided into a certain number of blocks of 1K or 4K bytes, as determined by the predi- 
cate BITFS() applied to the minor device number where the file system is mounted. Block 0 is unused and 
is available to contain a bootstrap program, pack label, or other information. 


Block 1 is the super block. The layout of the super block as defined by the include file <sys/filsys.h> is: 


/* 

* Structure of the super-block 
*/ 

struct  filsys 

{ 


unsigned short s_isize; 
daddr t_ s_fsize; 


short s_ninode; 

ino t s_inode[NICINOD]; 
char s_flock; 

char s_ilock; 

char s_fmod; 

char s_ronly; 


time_t s_time; 
daddr t_ s_tfree; 
ino t s_tinode; 
short s_dinfo[2] 
#define s_m s_dinfo[0] 
1] 


> 


#define s n s_dinfo[ 
char s_fsmnt[14]; 
ino t s_lasti; 
ino t s_nbehind; 
union { 

struct { 
short 
daddr t 
}R; 
struct { 
char 
#define BITMAP 961 
long 
} B; 
} U; 


3 

#define s_nfree U.R.S_nfree 
#define s free U.R.S_free 
#define s_ valid U.B.S_valid 
#define s_bfree U.B.S_bfree 


#ifdef KERNEL 
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/* size in blocks of i-list */ 

/* size in blocks of entire volume */ 
/* number of i-nodes in s_inode */ 
/* free i-node list */ 

/* lock during free list manipulation */ 
/* lock during i-list manipulation */ 
/* super block modified flag */ 

/* mounted read-only flag */ 

/* last super block update */ 

/* total free blocks*/ 

/* total free inodes */ 

/* interleave stuff */ 


/* ordinary file mounted on */ 
/* start place for circular search */ 
/* est # free inodes before s_lasti */ 


S_nfree;/* number of addresses in s_free */ 
S_free[NICFREE];/* free block list */ 


S_valid;/* 1 on disk means bit map valid */ 


S_bfree[BITMAP];/* bit map for free data blocks */ 
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struct filsys *getfs(); 
#endif 


S_isize is the address of the first block after the i-list, which starts just after the super-block, in block 2. 
Thus the i-list is s_isize—2 blocks long. S_fsize is the address of the first block not potentially available for 
allocation to a file. These numbers are used by the system to check for bad block addresses; if an “impossi- 
ble’ block address is allocated from the free list or is freed, a diagnostic is written on the on-line console. 
Moreover, the free array is cleared, so as to prevent further allocation from a presumably corrupted free list. 


The free list for a 1K file system is maintained as follows. The s_free array contains, in s_free[/], ... , 
s_free[s_nfree—1], up to NICFREE free block numbers. NICFREE is a configuration constant. S_free[0] 
is the block address of the head of a chain of blocks constituting the free list. The layout of each block of 
the free chain as defined in the include file <sys/fblk.h> is: 


struct fblk 
{ 

int df_nfree; 

daddr t df_free[NICFREE]; 
}; 
The fields df_nfree and df_free in a free block are used exactly like s_nfree and s_free in the super block. 
To allocate a block: decrement s_nfree, and the new block number is s_free[s_nfree]. If the new block 
address is 0, there are no blocks left, so give an error. If s_nfree became 0, read the new block into s_nfree 
and s_free. To free a block, check if s_nfree is NICFREE; if so, copy s_nfree and the s_free array into it, 
write it out, and set s_nfree to 0. In any event set s_free[s_nfree] to the freed block’s address and incre- 
ment s_nfree. 


The free list for a 4K file system is a bitmap. The bit (s_bfree[i/w |>>(i%w))&1, where w is the bit size of a 
long, is nonzero if the ith data block is free. The bitmap of a mounted file system is maintained only in 
main memory; the bitmap on the medium is marked invalid by setting s_valid to zero. Unmounting 
updates the medium copy and sets s_valid to 1. A file system with invalid bitmap may be mounted read- 
only; its bitmap can be corrected by fsck(8). 


S_ninode is the number of free i-numbers in the s_inode array. To allocate an i-node: if s_ninode is greater 
than 0, decrement it and return s_inode[s_ninode]. If it was 0, read the i-list and place the numbers of all 
free inodes (up to NICINOD) into the s_inode array, then try again. To free an i-node, provided s_ninode is 
less than NICINODE, place its number into s_inode[s_ninode] and increment s_ninode. If s_ninode is 
already NICINODE, don’t bother to enter the freed i-node into any table. This list of i-nodes is only to 
speed up the allocation process; the information as to whether the inode is really free or not is maintained in 
the inode itself. 


The fields s_/asti and s_nbehind are used to avoid searching the inode list from the beginning each time the 
system runs out of inodes. S lasti gives the base of the block of inodes last searched on the filesystem 
when inodes ran out, and s_nbehind gives the number of inodes, whose numbers were less than s_lasti 
when they were freed with s_ninode already NICINODE. Thus s_ninode is the number of free inodes 
before s_lasti. The system will search forward for free inodes from s_lJasti for more inodes unless 
s_nbehind is sufficiently large, in which case it will search the file system inode list from the beginning. 
This mechanism avoids quadratic behavior in allocating inodes. 


S_flock and s_ilock are flags maintained in the core copy of the file system while it is mounted and their 
values on disk are immaterial. The value of s_fmod on disk is likewise immaterial; it is used as a flag to 
indicate that the super-block has changed and should be copied to the disk during the next periodic update 
of file system information. S_ronly is a write-protection indicator; its disk value is also immaterial. 


S_time is the last time the super-block of the file system was changed. During a reboot, s_time of the 
super-block for the root file system is used to set the system’s idea of the time. 


The fields s_tfree, s_tinode, s_fname and s_fpack are not currently maintained. 
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I-numbers begin at 1, and the storage for i-nodes begins in block 2. I-nodes are 64 bytes long, so 16 of 
them fit into a block. I-node 2 is reserved for the root directory of the file system, but no other i-number 
has a built-in meaning. Each i-node represents one file. The format of an i-node as given in the include file 
<sys/ino.h> is: 


/* 
* Inode structure as it appears on 
* a disk block. 


*/ 

struct dinode 

{ 
unsigned short di_mode;/* mode and type of file */ 
short dinlink; /* number of links to file */ 
short di_uid; /* owner’s user id */ 
short di_gid; /* owner’s group id */ 
off t di_size; /* number of bytes in file */ 
char di_addr[40]; /* disk block addresses */ 
time _t di_atime; /* time last accessed */ 
time _t di_mtime; /* time last modified */ 
time t di_ctime; /* time created */ 

Is 

/* 


* the 40 address bytes: 

* 39 used; 13 addresses 
* of 3 bytes each. 

*/ 


Di_mode tells the kind of file; it is encoded identically to the st_mode field of stat(2). Di_nlink is the num- 
ber of directory entries (links) that refer to this inode. Di_uid and di_gid are the owner’s user and group 
IDs. Size is the number of bytes in the file. Di_atime and di_mtime are the times of last access and 
modification of the file contents (read, write or create) (see times(2)); Di_ctime records the time of last 
modification to the inode or to the file, and is used to determine whether it should be dumped. 


Special files are recognized by their modes and not by i-number. A block-type special file is one which can 
potentially be mounted as a file system; a character-type special file cannot, though it is not necessarily 
character-oriented. For special files, the di_addr field is occupied by the device code (see types(5)). The 
device codes of block and character special files overlap. 


A symbolic link is, aside from mode, a plain file whose sole content is the name of the file linked to. 


Disk addresses of plain files and directories are kept in the array di_addr packed into 3 bytes each. The first 
10 addresses specify device blocks directly. The last 3 addresses are singly, doubly, and triply indirect and 
point to blocks of 256 block pointers. Pointers in indirect blocks have the type daddr_t (see types(5)). 


For block b in a file to exist, it is not necessary that all blocks less than b exist. A zero block number either 
in the address words of the i-node or in an indirect block indicates that the corresponding block has never 
been allocated. Such a missing block reads as if it contained all zero words. 


SEE ALSO 
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fsck(8), icheck(8), dcheck(8), dir(5), mount(8), stat(2), types(5) 
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NAME 


fstab — static information about the filesystems 


SYNOPSIS 


#include <fstab.h> 


DESCRIPTION 


The file /etc/fstab contains descriptive information about the various file systems. /etc/fstab is only read by 
programs, and not written; it is the duty of the system administrator to properly create and maintain this file. 


These programs use /etc/fstab: dump, mount, umount, swapon, fsck and df. The order of records in /etc/fstab 
is important; fsck, mount, and umount depend on it. 


The special file name is the block special file name, and not the character special file name. If a program 
needs the character special file name, the program must create it by inserting an ‘r’ after the last ‘/ in the 
special file name. 


#define FSTAB "etc/fstab" 
#define FSFNMLG 16 


#define FSTABFMT = _"%16s:%168:%2s:%d:%d\n" 
#define FSTABARG(p) (p)—>fs_ spec, (p)—>fs_file, \ 

(p)—>fs_type, &(p)—>fs_freq, &(p)—>fs_passno 
#define FSTABNARGS 5 


#define FSTAB RW "rw" /* read write device */ 
#define FSTAB RO — "ro" /* read only device */ 
#define FSTAB SW "sw" /* swap device */ 
#define FSTAB XX "xx" /* ignore totally */ 


struct fstab { 
char fs_spec[FSNMLG]; /* block special device name */ 
char fs file[FSNMLG]; /* file system path prefix */ 


char fs_type[3]; /* rw,rO,SW Or Xx */ 
int fs_ freq; /* dump frequency, in days */ 
int fs passno; /* pass number on parallel dump */ 


}; 


The proper way to read records from /etc/fstab is to use the routines getfsent(), getfsspec() or getfsfile(). 


FILES 
/etc/fstab 
SEE ALSO 
getfsent(3) 


Page | 


GROUP (5) Eighth Edition GROUP(5) 


NAME 
group — group file 
DESCRIPTION 
Group contains for each group the following information: 


group name 
encrypted password 
numerical group ID 
a comma separated list of all users allowed in the group 


This is an ASCII file. The fields are separated by colons; Each group is separated from the next by a new- 
line. If the password field is null, no password is demanded. 


This file resides in directory /etc. Because of the encrypted passwords, it can and does have general read 
permission and can be used, for example, to map numerical group ID’s to names. 


FILES 

/etc/group 
SEE ALSO 

newerp(1), crypt(3), passwd(1), passwd(5) 
BUGS 


The passwd(1) command won’t change the passwords. 
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NAME 
map — digitized map formats 


DESCRIPTION 
Files used by map(7) are a sequence of structures of the form: 


struct { 
char patchlatitude; 
char patchlongitude; 
short n; 
union { 
struct { 
short latitude; 
short longitude; 
} point[n]; 
struct { 
short latitutde; 
short longitude; 
struct { 
char latdiff; 
char londiff; 
} point{-n); 
} highres; 
} segment; 
}s 
Patchlatitude and patchlongitude tell to what 10-degree by 10-degree patch of the earth’s surface a segment 
belongs. Their values range from —9 to 8 and from —18 to 17, respectively, and indicate the coordinates of 
the southeast corner of the patch in units of 10 degrees. 


Each segment of abs(n) points is connected; consecutive segments are not necessarily related. Latitude and 
longitude are measured in units of 0.0001 radian. If is negative, then differences to the first and succeeed- 
ing points are measured in units of 0.00001 radian. Latitude is counted positive to the north and longitude 
positive to the west. 


The patches are ordered lexicographically by patchlatitude then patchlongitude. A printable index to the 
first segment of each patch in a file named map is kept in an associated file named map.x. Each line of an 
index file contains patchlatitude, patchlongitude and the byte position of the patch in the map file. 


SEE ALSO 
map(7), map(3) 
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NAME 
mtab — mounted file system table 


DESCRIPTION 
Mtab resides in directory /etc and contains a table of devices mounted by the mount command. Umount 
removes entries. 


Each entry is 64 bytes long; the first 32 are the null-padded name of the place where the special file is 
mounted; the second 32 are the null-padded name of the special file. The special file has all its directories 
stripped away; that is, everything through the last ‘/’ is thrown away. 


This table is present only so people can look at it. It does not matter to mount if there are duplicated entries 
nor to umount if a name cannot be found. 


FILES 
/etc/mtab 
SEE ALSO 
mount(8) 
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NAME 


news — USENET network news article, utility files 


DESCRIPTION 
There are two formats of news articles: A and B. A format is the only format that version | netnews sys- 
tems can read or write. Systems running the version 2 netnews can read either format and there are provi- 
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sions for the version 2 netnews to write in A format. A format looks like this: 


Aarticle-ID 
newsgroups 
path 

date 

title 

Body of article 


Eighth Edition 
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Only version 2 netnews systems can read and write B format. B format contains two extra pieces of infor- 
mation: receival date and expiration date. The basic structure of a B format file consists of a series of 
headers and then the body. A header field is defined as a line with a capital letter in the Ist column and a 
colon somewhere on the line. Unrecognized header fields are ignored. News is stored in the same format 
transmitted, see “‘Standard for the Interchange of USENET Messages’’ for a full description. The follow- 


ing fields are among those recognized: 


Header Information 


From: user@host.domain[.domain ...] (Full Name) 


Newsgroups: Newsgroups 
Message-ID: <Unique Identifier> 
Subject: descriptive title 
Date: Date Posted 


Date-Received: Date received on local machine 


Expires: Expiration Date 
Reply-To: Address for mail replies 
References: Article ID of article this is 
Control: Text of a control message 


Here is an example of an article: 


Relay-Version: B 2.10 = 2/13/83 cbosgd. UUCP 
Posting-Version: B 2.10 2/13/83 eagle. UUCP 
Path: cbosgd!mhuxj!mhuxt!eagle!jerry 

From: jerry @eagle.uucp (Jerry Schwarz) 
Newsgroups: net.general 

Subject: Usenet Etiquette -- Please Read 
Message-ID: <642 @eagle. UUCP> 

Date: Friday, 19-Nov-82 16:14:55 EST 
Followup-To: net.news 

Expires: Saturday, 1-Jan-83 00:00:00 EST 
Date-Received: Friday, 19-Nov-82 16:59:30 EST 
Organization: Bell Labs, Murray Hill 


The body of the article comes here, after a blank line. 


A sys file line has four fields, each seperated by colons: 
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system-name: subscriptions: flags:transmission command 
Of these fields, on the system-name and subscriptions need to be present. 


The system name is the name of the system being sent to. The subscriptions is the list of newsgroups to be 
transmitted to the system. The flags are a set of letters describing how the article should be transmitted. 
The default is B. Valid flags include A (send in A format), B (send in B format), N (use ihave/sendme pro- 
tocol), U (use uux -c and the name of the stored article in a %s string). 


The transmission command is executed by the shell with the article to be transmitted as the standard input. 
The default is uux ——-z -r sysname!rnews. Some examples: 


xyz:net.all 

oldsys:net.all,fa.all,to.oldsys:A 
berksys:net.all,ucb.all::/usr/lib/news/sendnews —b berksys:rnews 
arpasys:net.all,arpa.all::/usr/lib/news/sendnews —a rnews @ arpasys 
old2:net.all,fa.all: A:/usr/lib/sendnews —o old2:rnews 
user:fa.sf-lovers::mail user 


Somewhere in a sys file, there must be a line for the host system. This line has no flags or commands. A # 
as the first character in a line denotes a comment. 


The history, active, and ngfile files have one line per item. 


SEE ALSO 
inews(8), postnews(1), sendnews(8), uurec(8), readnews(1) 
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NAME 
newsrc — information file for readnews 
DESCRIPTION 
The .newsrc file contains the list of previously read articles and an optional options line for readnews (1). 
Each newsgroup that articles have been read from has a line of the form: 
newsgroup: range 
The range is a list of the articles read. It is basically a list of no.’s separated by commas with sequential 
no.’s collapsed with hyphens. For instance: 
general: 1-78,80,85-90 
fa.info-cpm: 1-7 
net.news: 1 
fa.info-vax! 1-5 
If the : is replaced with an ! (as in info-vax above) the newsgroup is not subscribed to and will not be 
shown to the user. 
An options line starts with the word options (left-justified). Then there are the list of options just as they 
would be on the command line. For instance: 
options —n all !fa.sf-lovers !fa.human-nets —r 
options -c -r 
A string of lines beginning with a space or tab after the initial options line will be considered continuation 
lines. 
FILES 
*/ newsrc options and list of previously read articles 
SEE ALSO 
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readnews(1), checknews(1) 
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NAME 


passwd — password file 


DESCRIPTION 


FILES 


Passwd contains for each user the following information: 


name (login name, contains no upper case) 

encrypted password 

numerical user ID 

numerical group ID 

GCOS job number, box number, optional GCOS user-id 
initial working directory 

program to use as Shell 


This is an ASCII file. Each field within each user’s entry is separated from the next by a colon. The GCOS 
field is used only when communicating with that system, and in other installations can contain any desired 
information. Each user is separated from the next by a new-line. If the password field is null, no password 
is demanded; if the Shell field is null, the Shell itself is used. 


This file resides in directory /etc. Because of the encrypted passwords, it can and does have general read 
permission and can be used, for example, to map numerical user ID’s to names. 


/etc/passwd 


SEE ALSO 
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getpwent(3), login(8), crypt(3), passwd(1), group(5) 
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NAME 


DESCRIPTION 
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plot — graphics interface 


Files of this format are produced by routines described in plot(3), and are interpreted for various devices by 
commands described in plot(1). A graphics file is an ASCII stream of instruction lines. Arguments are 
delimited by spaces, tabs, or commas. Numbers may be floating point. Punctuation marks (except ‘:’), 
spaces, and tabs at the beginning of lines are ignored. Comments run from ‘:’ to newline. Instructions 
may be the whole function name or just enough characters to disambiguate it. (Thus ..line, line, or li are all 
valid instructions.) Arguments are interpreted as follows: 


1. 
2. 


If an instruction requires no arguments, the rest of the line is ignored. 


If it requires a string argument, then all the line after the first field separator is passed as argument. 
Quote marks may be used to preserve leading blanks. Strings may include newlines represented as 
‘\n’. 
Between numeric arguments alphabetic characters and punctuation marks are ignored. Thus 

line from 5 6 to 7 8 
draws a line from (5, 6) to (7, 8). 


Instructions with numeric arguments remain in effect until a new instruction is read. Such com- 
mands may spill over many lines. Thus the following sequence will draw a polygon with vertices 
(4.5, 6.77), (5.8, 5.6), (7.8, 4.55), and (10.0, 3.6). 


move 4.5 6.77 
vec 5.8, 5.6 7.8 
4.55 10.0, 3.6 4.5, 6.77 


The instructions are executed in order. The last designated point in a line, move, rmove, vec, rvec, arc or 
point command becomes the ‘current point’ (X, Y) for the next command. Each of the following descrip- 
tions corresponds to a routine in plot(3). 


Open & Close 


o[penpl] string 


cl[osepl] 


Open plotting device. For troff string specifies the size of the plot (default is 61.) 


Close plotting device. 


Basic Plotting Commands 


e[rase] 


Start another frame of output or erase the screen on CRT terminals without scroll. 


m{[ove] x y Current point becomes x y. 


rm[ove] dx dy 


Current point becomes X+dx Y+dy. 


poi[nt] x y Plot the point x y and make it the current point. 


v[ec] x y 


Draw a line from the current point to x y. 


li{ne] x/ yl x2 y2 


Draw a line from x/ y/ to x2 y2. Make the current point x2 y2. 


t[ext] string 


Place the following ASCII string so that its first character is centered on the current point 
(default). If string begins with ‘\C’, the string is centered on the current point. If string begins 
with ‘\R’, the string is right adjusted on the current point. A backslash at the beginning of the 
string may be escaped with another backslash (‘\’). 


a[rc] x1 yl x2 y2 xc ycr 


Draw a circular arc from x/ y/ to x2 y2 with center xc yc and radius r. If the radius is positive, 
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the arc is drawn counterclockwise; if the radius is negetive, the arc is drawn clockwise. The 
starting point is exact but the ending point is approximate. 


ci[rcle] xc yc r 
Draw a circle centered at xc yc with radius r. If the range and frame parameters do not specify a 
square, the circle will be elliptical. 

di[sc] xc yc r 
Draw a solid circle centered at xc yc with radius r using the filling color (see efill below). disc 
only works on the 5620; on other devices disc is the same as circle. 

bo[x] xJ yl x2 y2 
Draw a box with lower left hand corner at x/ y/ and upper right hand corner at x2 y2. 

sb[ox] x/ yl x2 y2 
Draw a solid box with lower lefthand corner at x/ y/ and upper righthand corner at x2 y2 using 
the filling color (see cfill below). 


par[abola] x/ yl x2 y2 xg yg 
Draw a parabola from x/ y/ to x2 y2 ‘guided’ by xg yg. The parabola passes through the mid- 
point of the line joining xg yg with the midpoint of the line joining x/ y/ and x2 y2 and is tan- 
gent to the lines from xg yg to the endpoints. 


polly] { {x/ yl... xn yn} ... {X1 Y1... Xm Ym} } 
Draw polygons with vertices x/ yl ... xn yn and X/ YI ... Xm Ym. If only one polygon is 
specified, the inner brackets are not needed. If square brackets ‘[ ]’ are used, the first vertex is 
repeated at the end of the list to close the polygon. 


fi{ill] { {x/ yl... xn yn} ... {X17 YI... Xm Ym} } 
Fill a polygon. The arguments are the same as those for poly above except that the first vertex 
is automatically repeated to close each polygon. The polygons do not have to be connected. 
Enclosed polygons appear as holes. 


sp[line] { {x/ yl ... xn yn} ... {X17 Y1 ... Xm Ym} } 
Draw a parabolic spline guided by x/ y/ ... xn yn with simple endpoints. 


fsp[line] { {x/ yl... xn yn} ... {X71 YI... Xm Ym} } 
Draw a parabolic spline guided by x/ yl ... xn yn with double first endpoint. 


Isp[line] { {x/ yl... xn yn}... {X1 YI... Xm Ym} } 
Draw a parabolic spline guided by x/ y/ ... xn yn with double last endpoint. 


dsp[line] { {x/ yl... xn yn} ... {XI Y1... Xm Ym} } 
Draw a parabolic spline guided by x/ yl ... xn yn with double endpoints. 


esp[line] { {a/ yl... xn yn} ... {X71 YI... Xm Ym} } 
Draw a closed parabolic spline guided by x/ y/ ... xn yn. 


in[clude] filename 
Take commands from file filename. 


de[fine] string { commands } 
Define string as commands. 


ca[ll] string scale 
Invoke commands defined as string applying scale to all coordinates. 


Commands Controlling the Environment 


co[lor] string 
Draw lines with color string. Available colors depend on the device. String may contain 
definitions for several devices separated by ‘‘/’’. Colors possible for the various devices are: 
pen black, red, green, blue, Tblack, Tred, Tgreen, Tblue 
(assumes default carousel, T=thick) 
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pe[n] string 


ef[ill] string 


All devices 
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1-8 (pen number) 

/Snumber character size as a % of plotting area 
ramtek red, green, blue, magenta, yellow, cyan, white 
troff  /Fstring font 

/Pnumber point size 
2621 /Acharacter used for plotting 


Use string as the style for drawing lines. Not all pen styles are implemented for all devices. 
String may contain definitions for several devices separated by ‘‘/’’. The available pen styles 
are: 
pen solid, dott[ed], short, long, dotd[ashed], cdash, ddash 
where cdash and ddash are combinations of long and short 
4014 _ solid, dott[ed], short, long, dotd[ashed], ddash 
troff solid, dash where only straight lines will be dashed 
5620  /Bnumber for line thickness 
2621  /Acharacter character used for plotting 


Use string as color for filling. String may contain the definitions for several devices separated 
by ‘/. The following colors are available on the specified devices: 
pen black, red, green, blue, Tblack, Tred, Tgreen, Tblue 
1-8 pen number 
ramtek red, green, blue, magenta, yellow, cyan, white 
5620 = /Btexture string with octal numbers for texture; see types(9.5). 
The 16 words of texture should be followed by one word for the mode used 
by texture (see bitbit(9.3) 
2621  /Acharacter character to use for filling 


/Adegrees angle of slant of shading lines 
/Gnumber gap between shading lines (in user units) 


ra[nge] x/ yl x2 y2 


The data will fall between x/ y/ and x2 y2. The plot will be magnified or reduced to fit the 
device as closely as possible. 


Range settings that exactly fill the plotting area with unity scaling appear below for devices 
supported by the filters of plot(1). The upper limit is just outside the plotting area. In every 
case the plotting area is taken to be square; points outside may be displayable on devices with 
nonsquare faces. 


4014 range(0.,, 0.,, 3120.,, 3120.); 

troff range(0.,0.,6144., 6144.); 

ramtek range(0., 0., 511., 511.); 

2621 range(0., 0., 22., 22.); 

5620 range dependent on layer size 

pen range dependent on paper size 
fr[ame] px pyl px2 py2 


sa[ve] 


re[store] 


The data will be plotted in the fraction of the display specified by px/ py! for lower lefthand 
corner and px2 py2 for upper righthand corner. Thus frame .5 0 1. .5 plots in the lower right 
quadrant of the display; frame 0. 1. 1. 0. uses the whole display but inverts the y coordinates. 


Save the current environment, and move to a new one. The new environment inherits the old 
one. There are 7 levels of environment. 


Restore previous environment. 
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SEE ALSO 
plot(1), plot(3), graph(1) 
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NAME 
stab — symbol table types 


SYNOPSIS 
#include <stab.h> 


DESCRIPTION 

Stab.h defines some values of the n_type field of the symbol table of a.out files. These are the types for per- 
manent symbols (i.e. not local labels, etc.) used by the compiler cc(1), the debugger pi(1) and the Berkeley 
Pascal compiler pc(1). Symbol table entries can be produced by the . stabs assembler directive. This allows 
one to specify a double-quote delimited name, a symbol type, one char and one short of information about 
the symbol, and an unsigned long (usually an address). To avoid having to produce an explicit label for the 
address field, the .stabd directive can be used to implicitly address the current location. If no name is 
needed, symbol table entries can be generated using the .stabn directive. The loader promises to preserve 
the order of symbol table entries produced by .stab directives. As described in a.out(5), an element of the 
symbol table consists of the following structure: 


/* 
* Format of a symbol table entry. 
**/ 
struct nlist { 
union { 
char *n_name;/* for use when in-core */ 
long n_strx; /* index into file string table */ 
} n_un; 
unsigned char n_type; /* type flag */ 
char n_other; /* unused */ 
short n_desc; /* see struct desc, below */ 
unsigned n_ value; /* address or offset or line */ 


}s 

The low bits of the n_type field are used to place a symbol into at most one segment, according to the fol- 
lowing masks, defined in <a.out.h>. A symbol can be in none of these segments by having none of these 
segment bits set. 


/* 

* Simple values for n_type. 

**/ 
#define N UNDF 0x0 /* undefined */ 
#define N_ABS Ox2 /* absolute */ 
#define N TEXT 0x4 /* text */ 
#define N DATA 0x6 /* data */ 
#define N_BSS Ox8 /* bss */ 


#define N EXT 01 /* external bit, or’ed in */ 


The n_value field of a symbol is relocated by the linker, /d(1) as an address within the appropriate segment. 
N_value fields of symbols not in any segment are unchanged by the linker. In addition, the linker will dis- 
card certain symbols, according to rules of its own, unless the n_type field has one of the following bits set: 
/* 

* Other permanent symbol table entries have some of the N_STAB bits set. 

* These are given in <stab.h> 

**/ 
#define N STAB —OxeO /* if any of these bits set, don’t discard */ 
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This allows up to 112 (7 * 16) symbol types, split between the various segments. Some of these have 


already been claimed. The transcendental debugger, pi(9.1), uses the following n_type values: 


/* 


* stabs for text symbols (must be 0x?4): 


*/ 
#define N_BFUN 
#define N_FUN 
#define N NARGS 
#define N_SLINE 
#define N SO 
#define N_ SOL 
#define N ESO 
#define N ENTRY 
#define N_ RFUN 
#define N LBRAC 
#define N RBRAC 
#define N EFUN 
[* 


0x24 /* procedure: name,,0,lineno,address */ 
0x24 

0x34 /* function call: ,,0,nbytes,address */ 
0x44 /* src line: ,,0,lineno,address */ 
0x64 /* source file: name,,0,lineno,address */ 


0x84 /* #include file: name,,0,lineno,address = _*/ 
0x94 /* end source file: name,,0,lineno,address */ 
Oxa4 /* alternate entry: name,,0,lineno,address */ 
Oxb4 /* return from function: ,,0,lineno,address */ 
Oxc4 /* left bracket: ,,0,level,address */ 
Oxd4 /* right bracket: ,,0,level,address */ 
Oxf4 /* end of function: name,,0,lineno,address */ 


* stabs for data symbols (must be 0x76): 


*/ 
#define N STSYM 
/* 


0x26 /* static symbol: name,,0,type,address */ 


* stabs for bss symbols (must be 0x?8): 


*/ 
#define N LCSYM 
#define N ECOML 
/* 


0x28 /* .lcomm symbol: name,,0,type,address */ 
Oxe8 /* end common (local name): ,,address —*/ 


* stabs for non-relocated stuff: 


*/ 
#define N GSYM 
#define N FNAME 
#define N_STFUN 
#define N RSYM 
#define N BSTR 
#define N_ ESTR 


0x20 /* global symbol: name,,0,type,0 */ 
0x22 /* procedure name (f77 kludge): name,,0 */ 
0x32 /* static function: name,,0,type,0 */ 
0x40 /* register sym: name,,0,type,register */ 


OxSc /* begin structure: name,,0,typelength  */ 
OxSe /* end structure: name,,0,type,length */ 


#define N SSYM 0x60 /* structure elt: name,,0,type,offset */ 
#define N SFLD —_0x70//* structure field: name,,0,type,offset */ 
#define N LSYM = 0x80 //* local sym: name,,0,type, offset */ 
#define N PSYM = Oxa0 /* parameter: name,,0,type,offset */ 
#define N_ BCOMM Oxe2 /* begin common: name,, */ 
#define N ECOMM Oxe4 /* end common: name,, */ 
#define N_VER Oxf0 /* symbol table version number */ 
#define N_TYID Oxfa /* struct, union, or enum name */ 
#define N_DIM Oxfc /* dimension for arrays */ 


where the comments give the sdb conventional use for .stabs and the n_name, n_other, n_desc, and n_value 
fields of the given n_type. Pi uses the n_desc field to hold a type specifier in the form used by cc(1), in 
which a base type is qualified in the following structure: 


struct desc { 
short q6:2, 
q5:2, 
q4:2, 
q3:2, 
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q2:2, 
ql:2, 
basic:5; 


}; 


There are four qualifications, with q1 the most significant and q6 the least significant: 


0 none 
1 pointer 
2 function 
3 array 
The sixteen basic types are assigned as follows: 
0 undefined 
1 function argument 
2 character 
3 short 
4 int 
5 long 
6 float 
7 double 
8 structure 
9 union 
10 enumeration 
11 member of enumeration 
12 unsigned character 
13 unsigned short 
14 unsigned int 
15 unsigned long 
16 void 


The Berkeley Pascal compiler, pc(1), uses the following n_type value: 
#define N PC 0x30 = /* global pascal symbol: name,,0,subtype,line */ 


and uses the following subtypes to do type checking across separately compiled files: 


1 source file name 
included file name 
global label 
global constant 
global type 
global variable 
global function 
global procedure 
external function 

0 external procedure 


FP OMmAANAUNAWWN 


SEE ALSO 


BUGS 
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as(1), 1d(1), pi(1), a.out(5) 


The loader’s relocation conventions limit the number of useful n_type’s. 


More basic types are needed. 
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NAME 

termcap — terminal capability data base 
SYNOPSIS 

/etc/termcap 
DESCRIPTION 


Termcap is a data base describing terminals, used, e.g., by vi(1) and curses(3). Terminals are described in 
termcap by giving a set of capabilities which they have, and by describing how operations are performed. 
Padding requirements and initialization sequences are included in termcap. 


Entries in termcap consist of a number of *:’ separated fields. The first entry for each terminal gives the 
names which are known for the terminal, separated by ‘ |’ characters. The first name is always 2 characters 
long and is used by older version 6 systems which store the terminal type in a 16 bit word in a systemwide 
data base. The second name given is the most common abbreviation for the terminal, and the last name 
given should be a long name fully identifying the terminal. The second name should contain no blanks; the 
last name may well contain blanks for readability. 


CAPABILITIES 


Page | 


(P) indicates padding may be specified 
(P*) indicates that padding may be based on no. lines affected 


Name Type Pad? Description 


ae str (P) End alternate character set 

al str (P*) Add new blank line 

am __ bool Terminal has automatic margins 

as str (P) Start alternate character set 

be str Backspace if not “H 

bs bool Terminal can backspace with “H 

bt str (P) Back tab 

bw bool Backspace wraps from column 0 to last column 

CC str Command character in prototype if terminal settable 


cd str (P*) Clear to end of display 
ce str (P) Clear to end of line 


ch str (P) Like cm but horizontal motion only, line stays same 
cl str (P*) Clear screen 

cm str. (P) Cursor motion 

co num Number of columns in a line 


cr str (P*) Carriage return, (default “M) 
cs str (P) Change scrolling region (vt100), like cm 
cv str. (P) Like ch but vertical only. 


da bool Display may be retained above 

dB num Number of millisec of bs delay needed 
db bool Display may be retained below 

dC num Number of millisec of cr delay needed 
de str (P*) Delete character 

dF num Number of millisec of ff delay needed 
dl str (P*) Delete line 

dm str Delete mode (enter) 

dN num Number of millisec of nl delay needed 
do str Down one line 

dT num Number of millisec of tab delay needed 
ed str End delete mode 

ei str End insert mode; give ‘‘:ei=:’’ if ic 

eo str Can erase overstrikes with a blank 


ff str (P*) Hardcopy terminal page eject (default “L) 
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kO-k9 


bool 


num 


str. (P*) 


str (P) 


str (P) 
str (P) 


num 
bool 
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Hardcopy terminal 

Half-line down (forward 1/2 linefeed) 
Home cursor (if no em) 

Half-line up (reverse 1/2 linefeed) 
Hazeltine; can’t print ~’s 

Insert character 

Name of file containing is 

Insert mode (enter); give ‘*:im=:’’ if ic 
Insert mode distinguishes nulls on display 
Insert pad after character inserted 
Terminal initialization string 

Sent by ‘‘other’’ function keys 0-9 

Sent by backspace key 

Sent by terminal down arrow key 

Out of “‘keypad transmit’? mode 

Sent by home key 

Sent by terminal left arrow key 

Number of “‘other’’ keys 

Termcap entries for other non-function keys 
Sent by terminal right arrow key 

Put terminal in ‘‘keypad transmit’’ mode 
Sent by terminal up arrow key 

Labels on ‘‘other’’ function keys 

Number of lines on screen or page 

Last line, first column (if no cm) 

Arrow key map, used by vi version 2 only 
Safe to move while in insert mode 
Memory lock on above cursor. 

Safe to move while in standout and underline mode 
Memory unlock (turn off memory lock). 
No correctly working carriage return (DM2500,H2000) 
Non-destructive space (cursor right) 
Newline character (default \n) 

Terminal is a CRT but doesn’t scroll. 
Terminal overstrikes 

Pad character (rather than null) 

Has hardware tabs (may need to be set with is) 
End stand out mode 

Scroll forwards 

Number of blank chars left by so or se 
Begin stand out mode 

Scroll reverse (backwards) 

Tab (other than “I or with padding) 

Entry of similar terminal - must be last 
String to end programs that use cm 

String to begin programs that use cm 
Underscore one char and move past it 
End underscore mode 

Number of blank chars left by us or ue 
Terminal underlines even though it doesn’t overstrike 
Upline (cursor up) 

Start underscore mode 

Visible bell (may not move cursor) 
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ve str Sequence to end open/visual mode 

vs str Sequence to start open/visual mode 

xb bool Beehive (f1=escape, f2=ctrl C) 

xn bool A newline is ignored after a wrap (Concept) 

xr bool Return acts like ce \r \n (Delta Data) 

XS bool Standout not erased by writing over it (HP 264?) 
xt bool Tabs are destructive, magic so char (Teleray 1061) 
A Sample Entry 


The following entry, which describes the Concept—100, is among the more complex entries in the termcap 
file as of this writing. (This particular concept entry is outdated, and is used as an example only.) 


cl | c100 | concept100:is=\EU\Ef\E7\E5\E8\EN\ENH\EK\E\200\E0&\200:\ 
:al=3*\E*R:am:bs:cd=16*\E*C:ce=16\E*S:cl=2**L:cm=\Ea%+ %+ :co#80:\ 
:dc=16\E*A:d1=3*\E"B:ei=\E\200:e0:im=\E’P:in:ip=16*:1i#24:mi:nd=\E=:\ 
:se=\Ed\Ee:so=\ED\EE:ta=8\t:ul:up=\E;:vb=\EkK\EK:xn: 

Entries may continue onto multiple lines by giving a \ as the last character of a line, and that empty fields 

may be included for readability (here between the last field on a line and the first field on the next). Capa- 

bilities in termcap are of three types: Boolean capabilities which indicate that the terminal has some partic- 

ular feature, numeric capabilities giving the size of the terminal or the size of particular delays, and string 

capabilities, which give a sequence which can be used to perform particular terminal operations. 


Types of Capabilities 


All capabilities have two letter codes. For instance, the fact that the Concept has “‘automatic margins’’ (i.e. 
an automatic return and linefeed when the end of a line is reached) is indicated by the capability am. Hence 
the description of the Concept includes am. Numeric capabilities are followed by the character “#’ and then 
the value. Thus co which indicates the number of columns the terminal has gives the value “80” for the 
Concept. 


Finally, string valued capabilities, such as ce (clear to end of line sequence) are given by the two character 
code, an ‘=’, and then a string ending at the next following ‘:’. A delay in milliseconds may appear after 
the ‘=’ in such a capability, and padding characters are supplied by the editor after the remainder of the 
string is sent to provide this delay. The delay can be either a integer, e.g. ‘20’, or an integer followed by an 
“*’ Le. ‘3’, A “*’ indicates that the padding required is proportional to the number of lines affected by the 
operation, and the amount given is the per-affected-unit padding required. When a ‘*’ is specified, it is 
sometimes useful to give a delay of the form ‘3.5’ specify a delay per unit to tenths of milliseconds. 


A number of escape sequences are provided in the string valued capabilities for easy encoding of characters 
there. A \E maps to an ESCAPE character, “x maps to a control-x for any appropriate x, and the sequences \n 
\r \t \b \f give a newline, return, tab, backspace and formfeed. Finally, characters may be given as three 
octal digits after a \, and the characters ~ and \ may be given as V and \\. If it is necessary to place a: ina 
capability it must be escaped in octal as \072. If it is necessary to place a null character in a string capabil- 
ity it must be encoded as \200. The routines which deal with termcap use C strings, and strip the high bits 
of the output very late so that a \200 comes out as a \000 would. 


Preparing Descriptions 


We now outline how to prepare descriptions of terminals. The most effective way to prepare a terminal 
description is by imitating the description of a similar terminal in termcap and to build up a description 
gradually, using partial descriptions with ex to check that they are correct. Be aware that a very unusual ter- 
minal may expose deficiencies in the ability of the termcap file to describe it or bugs in ex. To easily test a 
new terminal description you can set the environment variable TERMCAP to a pathname of a file contain- 
ing the description you are working on and the editor will look there rather than in /etc/termcap. TERM- 
CAP can also be set to the termcap entry itself to avoid reading the file when starting up the editor. (This 
only works on version 7 systems.) 
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Basic capabilities 


The number of columns on each line for the terminal is given by the co numeric capability. If the terminal 
is a CRT, then the number of lines on the screen is given by the li capability. If the terminal wraps around to 
the beginning of the next line when it reaches the right margin, then it should have the am capability. If the 
terminal can clear its screen, then this is given by the cl string capability. If the terminal can backspace, 
then it should have the bs capability, unless a backspace is accomplished by a character other than “H (ugh) 
in which case you should give this character as the be string capability. If it overstrikes (rather than clear- 
ing a position when a character is struck over) then it should have the os capability. 


A very important point here is that the local cursor motions encoded in termcap are undefined at the left and 
top edges of a CRT terminal. The editor will never attempt to backspace around the left edge, nor will it 
attempt to go up locally off the top. The editor assumes that feeding off the bottom of the screen will cause 
the screen to scroll up, and the am capability tells whether the cursor sticks at the right edge of the screen. 
If the terminal has switch selectable automatic margins, the termcap file usually assumes that this is on, i.e. 
am. 


These capabilities suffice to describe hardcopy and ‘‘glass-tty’’ terminals. Thus the model 33 teletype is 
described as 


13 | 33 | tty33:co#72:0s 
while the Lear Siegler ADM-3 is described as 

cl | adm3]3|Isi adm3:am:bs:cl="Z:1i#24:co#80 
Cursor addressing 


Cursor addressing in the terminal is described by a cm string capability, with printf{(3s) like escapes %x in 
it. These substitute to encodings of the current line or column position, while other characters are passed 
through unchanged. If the cm string is thought of as being a function, then its arguments are the line and 
then the column to which motion is desired, and the % encodings have the following meanings: 


%od as in printf, O origin 

%o2 like %2d 

%3 like %3d 

%. like %c 

Jo+x adds x to value, then %. 

%>xy if value > x adds y, no output. 

Yor reverses order of line and column, no output 

%i increments line/column (for | origin) 

%o% gives a single % 

%n exclusive or row and column with 0140 (DM2500) 
%B BCD (16*(x/10)) + (x%10), no output. 

%D Reverse coding (x-2*(x%16)), no output. (Delta Data). 


Consider the HP2645, which, to get to row 3 and column 12, needs to be sent \E&al2cO3Y padded for 6 
milliseconds. Note that the order of the rows and columns is inverted here, and that the row and column are 
printed as two digits. Thus its em capability is ‘“cm=6\E& %r%2c%2Y’’. The Microterm ACT-IV needs the 
current row and column sent preceded by a “T, with the row and column simply encoded in binary, 
“cm="T%.%.”’. Terminals which use “*%.’’ need to be able to backspace the cursor (bs or be), and to 
move the cursor up one line on the screen (up introduced below). This is necessary because it is not always 
safe to transmit \t, \n “D and \r, as the system may change or discard them. 


A final example is the LSI ADM-3a, which uses row and column offset by a blank character, thus 
“cm=\E=%+ %+’’. 


Cursor motions 


If the terminal can move the cursor one position to the right, leaving the character at the current position 
unchanged, then this sequence should be given as nd (non-destructive space). If it can move the cursor up 
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a line on the screen in the same column, this should be given as up. If the terminal has no cursor address- 
ing capability, but can home the cursor (to very upper left corner of screen) then this can be given as ho; 
similarly a fast way of getting to the lower left hand corner can be given as Il; this may involve going up 
with up from the home position, but the editor will never do this itself (unless Il does) because it makes no 
assumption about the effect of moving up from the home position. 


Area clears 


If the terminal can clear from the current position to the end of the line, leaving the cursor where it is, this 
should be given as ce. If the terminal can clear from the current position to the end of the display, then this 
should be given as ed. The editor only uses ed from the first column of a line. 


Insert/delete line 


If the terminal can open a new blank line before the line where the cursor is, this should be given as al; this 
is done only from the first position of a line. The cursor must then appear on the newly blank line. If the 
terminal can delete the line which the cursor is on, then this should be given as dl; this is done only from 
the first position on the line to be deleted. If the terminal can scroll the screen backwards, then this can be 
given as sb, but just al suffices. If the terminal can retain display memory above then the da capability 
should be given; if display memory can be retained below then db should be given. These let the editor 
understand that deleting a line on the screen may bring non-blank lines up from below or that scrolling back 
with sb may bring down non-blank lines. 


Insert/delete character 


There are two basic kinds of intelligent terminals with respect to insert/delete character which can be 
described using termcap. The most common insert/delete character operations affect only the characters on 
the current line and shift characters off the end of the line rigidly. Other terminals, such as the Concept 100 
and the Perkin Elmer Owl, make a distinction between typed and untyped blanks on the screen, shifting 
upon an insert or delete only to an untyped blank on the screen which is either eliminated, or expanded to 
two untyped blanks. You can find out which kind of terminal you have by clearing the screen and then typ- 
ing text separated by cursor motions. Type ‘‘abc def’’ using local cursor motions (not spaces) between 
the ‘‘abc’’ and the ‘‘def’’. Then position the cursor before the ‘‘abc’’ and put the terminal in insert mode. 
If typing characters causes the rest of the line to shift rigidly and characters to fall off the end, then your ter- 
minal does not distinguish between blanks and untyped positions. If the ‘‘abc’’ shifts over to the ‘‘def”’ 
which then move together around the end of the current line and onto the next as you insert, you have the 
second type of terminal, and should give the capability in, which stands for ‘‘insert null’’. If your terminal 
does something different and unusual then you may have to modify the editor to get it to use the insert 
mode your terminal defines. We have seen no terminals which have an insert mode not not falling into one 
of these two classes. 


The editor can handle both terminals which have an insert mode, and terminals which send a simple 
sequence to open a blank position on the current line. Give as im the sequence to get into insert mode, or 
give it an empty value if your terminal uses a sequence to insert a blank position. Give as ei the sequence 
to leave insert mode (give this, with an empty value also if you gave im so). Now give as ic any sequence 
needed to be sent just before sending the character to be inserted. Most terminals with a true insert mode 
will not give ic, terminals which send a sequence to open a screen position should give it here. (Insert 
mode is preferable to the sequence to open a position on the screen if your terminal has both.) If post insert 
padding is needed, give this as a number of milliseconds in ip (a string option). Any other sequence which 
may need to be sent after an insert of a single character may also be given in ip. 


It is occasionally necessary to move around while in insert mode to delete characters on the same line (e.g. 
if there is a tab after the insertion position). If your terminal allows motion while in insert mode you can 
give the capability mi to speed up inserting in this case. Omitting mi will affect only speed. Some termi- 
nals (notably Datamedia’s) must not have mi because of the way their insert mode works. 


Finally, you can specify delete mode by giving dm and ed to enter and exit delete mode, and dc to delete a 
single character while in delete mode. 


TERMCAP(5) 5 (5/10/80) TERMCAP(5) 


Highlighting, underlining, and visible bells 


If your terminal has sequences to enter and exit standout mode these can be given as so and se respectively. 
If there are several flavors of standout mode (such as inverse video, blinking, or underlining — half bright is 
not usually an acceptable ‘‘standout’’ mode unless the terminal is in inverse video mode constantly) the 
preferred mode is inverse video by itself. If the code to change into or out of standout mode leaves one or 
even two blank spaces on the screen, as the TVI 912 and Teleray 1061 do, then ug should be given to tell 
how many spaces are left. 


Codes to begin underlining and end underlining can be given as us and ue respectively. If the terminal has 
a code to underline the current character and move the cursor one space to the right, such as the Microterm 
Mime, this can be given as uc. (If the underline code does not move the cursor to the right, give the code 
followed by a nondestructive space.) 


Many terminals, such as the HP 2621, automatically leave standout mode when they move to a new line or 
the cursor is addressed. Programs using standout mode should exit standout mode before moving the cur- 
sor or sending a newline. 


If the terminal has a way of flashing the screen to indicate an error quietly (a bell replacement) then this can 
be given as vb; it must not move the cursor. If the terminal should be placed in a different mode during 
open and visual modes of ex, this can be given as vs and ve, sent at the start and end of these modes respec- 
tively. These can be used to change, e.g., from a underline to a block cursor and back. 


If the terminal needs to be in a special mode when running a program that addresses the cursor, the codes to 
enter and exit this mode can be given as ti and te. This arises, for example, from terminals like the Concept 
with more than one page of memory. If the terminal has only memory relative cursor addressing and not 
screen relative cursor addressing, a one screen-sized window must be fixed into the terminal for cursor 
addressing to work properly. 


If your terminal correctly generates underlined characters (with no special codes needed) even though it 
does not overstrike, then you should give the capability ul. If overstrikes are erasable with a blank, then 
this should be indicated by giving eo. 


Keypad 


If the terminal has a keypad that transmits codes when the keys are pressed, this information can be given. 
Note that it is not possible to handle terminals where the keypad only works in local (this applies, for exam- 
ple, to the unshifted HP 2621 keys). If the keypad can be set to transmit or not transmit, give these codes as 
ks and ke. Otherwise the keypad is assumed to always transmit. The codes sent by the left arrow, right 
arrow, up arrow, down arrow, and home keys can be given as kl, kr, ku, kd, and kh respectively. If there 
are function keys such as f0, fl, ..., £9, the codes they send can be given as kO, K1, ..., k9. If these keys 
have labels other than the default f0 through f9, the labels can be given as 10, I, ..., 19. If there are other 
keys that transmit the same code as the terminal expects for the corresponding function, such as clear 
screen, the termcap 2 letter codes can be given in the ko capability, for example, “‘:ko=cl,llsf,sb:’’, which 
says that the terminal has clear, home down, scroll down, and scroll up keys that transmit the same thing as 
the cl, Il, sf, and sb entries. 


The ma entry is also used to indicate arrow keys on terminals which have single character arrow keys. It is 
obsolete but still in use in version 2 of vi, which must be run on some minicomputers due to memory limi- 
tations. This field is redundant with kl, kr, ku, kd, and kh. It consists of groups of two characters. In each 
group, the first character is what an arrow key sends, the second character is the corresponding vi com- 
mand. These commands are h for kl, j for kd, k for ku, 1 for kr, and H for kh. For example, the mime 
would be :ma="Kj*Zk*XI: indicating arrow keys left (H), down (*K), up (°Z), and right (“X). (There is no 
home key on the mime.) 


Miscellaneous 
If the terminal requires other than a null (zero) character as a pad, then this can be given as pe. 


If tabs on the terminal require padding, or if the terminal uses a character other than “T to tab, then this can 
be given as ta. 
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“~> 


Hazeltine terminals, which don’t allow “’ characters to be printed should indicate hz. Datamedia termi- 
nals, which echo carriage-return linefeed for carriage return and then ignore a following linefeed should 
indicate ne. Early Concept terminals, which ignore a linefeed immediately after an am wrap, should indi- 
cate xn. If an erase-eol is required to get rid of standout (instead of merely writing on top of it), xs should 
be given. Teleray terminals, where tabs turn all characters moved over to blanks, should indicate xt. Other 
specific terminal problems may be corrected by adding more capabilities of the form xx. 


Other capabilities include is, an initialization string for the terminal, and if, the name of a file containing 
long initialization strings. These strings are expected to properly clear and then set the tabs on the terminal, 
if the terminal has settable tabs. If both are given, is will be printed before if. This is useful where if is 
/usrNib/tabset/std but is clears the tabs first. 


Similar Terminals 


If there are two very similar terminals, one can be defined as being just like the other with certain excep- 
tions. The string capability te can be given with the name of the similar terminal. This capability must be 
last and the combined length of the two entries must not exceed 1024. Since termlib routines search the 
entry from left to right, and since the tc capability is replaced by the corresponding entry, the capabilities 
given at the left override the ones in the similar terminal. A capability can be cancelled with xx@ where xx 
is the capability. For example, the entry 


hn | 2621nl:ks @ :ke @:tc=2621: 


defines a 2621nl that does not have the ks or ke capabilities, and hence does not turn on the function key 
labels when in visual mode. This is useful for different modes for a terminal, or for different user prefer- 
ences. 


FILES 

/etc/termcap file containing terminal descriptions 
SEE ALSO 

ex(1), curses(3), termcap(3), tset(1), vi(1), ul(1) 
AUTHOR 

William Joy 


BUGS 
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Mark Horton added underlining and keypad support 


Ex allows only 256 characters for string capabilities, and the routines in termcap(3) do not check for 
overflow of this buffer. The total length of a single entry (excluding only escaped newlines) may not 
exceed 1024. 


The ma, vs, and ve entries are specific to the vi program. 


Not all programs support all entries. There are entries that are not supported by any program. 


TTYS (5) 


NAME 


Eighth Edition TTYS(5) 


ttys — terminal initialization data 


DESCRIPTION 


FILES 


The ttys file is read by the init program and specifies which terminal special files are to have a process cre- 
ated for them which will allow people to log in. It contains one line per special file. 


The first character of a line is either ‘0’ or ‘1’; the former causes the line to be ignored, the latter causes it to 
be effective. The second character is used as an argument to gefty(8), which performs such tasks as baud- 
rate recognition, reading the login name, and calling login(8). For normal lines, the character is ‘0’; other 
characters can be used, for example, with hard-wired terminals where speed recognition is unnecessary or 
which have special characteristics. (Getty will have to be fixed in such cases.) The remainder of the line is 
the terminal’s entry in the device directory, /dev. 


/etc/ttys 


SEE ALSO 
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init(8), getty(8), login(8) 


TYPES (5) Eighth Edition 


NAME 


types — primitive system data types 


SYNOPSIS 


#include <sys/types.h> 


DESCRIPTION 
The data types defined in the include file are used in UNIX system code; some data of these types are acces- 
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sible to user code: 


/* 
* Basic system types and major/minor device constructing/busting macros. 
*/ 


#ifndef_TYPES_ 
#define _TYPES_ 


/* major part of a device */ 
#define major(x) ((int)(((unsigned)(x)>>8)&0377)) 


/* minor part of a device */ 
#define minor(x) ((int)((x)&0377)) 


/* make a device number */ 
#define makedev(x,y) ((dev_t)(((x)<<8) | (y))) 


typedef unsigned char u_char; 
typedef unsigned short u_short; 
typedef unsigned int u_int; 

typedef unsigned long _u_long; 


typedef struct _physadr { int r[1]; } *physadr; 
typedef long daddr _t; 
typedef char * — caddr _t; 
typedef u_short ino t; 
typedef long swhlk _t; 
typedef long size_t; 
typedef long time_t; 
typedef long label_t[14]; 
typedef u_short dev _t; 
typedef long off t; 
typedef long portid t; 


#ifndef NBBY 
#include <sys/param.h> 
#endif NBBY 
/* 
* Set of fds used with the select system call. 
* The macros depend on NBPW, NBBY, & NOFILE from sys/param.h. 
**/ 
#define FDWORDS (NOFILE+NBPW*NBBY-1)/(NBPW*NBBY) 
typedef struct fd_set { unsigned long fds_bits[|FDWORDS]; } fd_set; 
#define FD SET(n,s) _—_(s).fds_bits[(n)/((NBPW*NBBY)] |= 1<<((n)%(NBPW*NBBY)) 
#define FD_CLR(n,s) —_(s).fds_bits[(n)/((NBPW*NBBY)] &= ~(1<<((n)%(NBPW*NBBY))) 
#define FD _ISSET(n,s) ((s).fds_bits[(n)/(NBPW*NBBY)] & (1<<((n)%(NBPW*NBBY)))) 


TYPES (5) 
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#define FD_ZERO(s) {int i; for”i=0;i<FDWORDS;i++)s.fds_bits[i]=0; } 


#endif_TYPES_ 


The form daddr_t is used for disk addresses except in an i-node on disk, see filsys(5). Times are encoded in 
seconds since 00:00:00 GMT, January 1, 1970. The major and minor parts of a device code specify kind 
and unit number of a device and are installation-dependent. Offsets are measured in bytes from the begin- 
ning of a file. The /abel_t variables are used to save the processor state while another process is running. 


SEE ALSO 
filsys(5), time(2), Iseek(2), adb(1) 
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NAME 
utmp, wtmp — login records 


SYNOPSIS 
#include <utmp.h> 


DESCRIPTION 
The utmp file allows one to discover information about who is currently logged in. The file is a sequence of 
entries with the following structure declared in the include file: 


/* 
* Structure of utmp and wtmp files. 
* 
* Assuming the number 8 is unwise. 
*/ 
struct utmp { 
char ut_line[8];  /* tty name */ 
char ut_name[8]; /* user id */ 
long —_ut_time; /* time on */ 
}s 
This structure gives the name of the special file associated with the user’s terminal, the user’s login name, 
and the time of the login in the form of time(2). 


The wimp file records all logins and logouts. Its format is exactly like utmp except that a null user name 
indicates a logout on the associated terminal. Furthermore, the terminal name ‘*’ indicates that the system 
was rebooted at the indicated time; the adjacent pair of entries with terminal names ‘ |° and “}’ indicate the 
system-maintained time just before and just after a date command has changed the system’s idea of the 
time. 


Wimp is maintained by login(8) and init(8). Neither of these programs creates the file, so if it is removed 


record-keeping is turned off. It is summarized by ac(8). 


FILES 
/etc/utmp 
/usr/adm/wtmp 


SEE ALSO 
login(8), init(8), who(1), ac(8) 
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NAME 


view2d — movie of a function f(x, y, t) 


DESCRIPTION 


Files of this format are produced by view2d(3), and displayed by commands in view2d(1). A movie file con- 
sists of one or more frames, each consisting of a header and a sequence of 16-bit signed integer values for 
each pixel, scanned left to right and bottom to top. (Left-to-right is the inner loop.) 


The header consists of the 32-bit magic number 0135246, then eight 16-bit integers: 
VER is the version number, currently 3. 


NX, NY 
specify the number of pixels in the frame. These may not vary from frame to frame. 


U,V _ relate pixel values p in the file to user function values f by 


p=utflr*xy, 
FIXUV normally 0; 1 if U, V, PMIN, PMAX of first frame give a bound on the data in the entire file. 
PMIN, PMAX 


limits of the data; only used when FIXUV=1. 
and finally a 16-byte ascii representation of a floating point value: 


TIME is a frame index, typically set to simulated time or to an iteration counter. This need not be uni- 
formly spaced from frame to frame, but should be nondecreasing. 


Any pixel value less than -32766 is treated as an ‘out of bounds’ marker and is not displayed. Other pixel 
values lie in the range [-32765,32765]. 


SEE ALSO 
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view2d(1), view2d(3) 


WHOAMI(5) Eighth Edition WHOAMI(5) 


NAME 
whoami — computer name 
SYNOPSIS 
cat /etc/whoami 
DESCRIPTION 
The file /etc/whoami contains one line of information — the name of the computer, as used in mail, rx, or 
uucp (1). 
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NAME 


adventure, zork, aardvark, rogue, wump — dungeon-exploration games 


SYNOPSIS 


/usr/games/adventure 
/usr/games/zork 
/usr/games/aardvark 
/usr/games/rogue 


/usr/games/wump 


DESCRIPTION 


FILES 


Adventure is the grandaddy of dungeon-exploration games, part of the object of which is to puzzle out the 
object and the rules. Zork marks the zenith of the genre; aardvark is yet another exemplar. 


Rogue requires a cursor-addressed terminal upon which appears a map of the cave pursuit. Indicia pub- 
lished at the bottom of the screen are the cave level being explored, the amount of gold accumulated, armor 
class, and measures of your potency: ‘hit points’, strength, and experience level. Type *?’ for more help. 


The wump cave is inhabited by a Wumpus and by Super Bats that like to pick you up and drop you some- 
where else. You wander among the rooms, trying to shoot the Wumpus with an arrow, meanwhile avoiding 
being eaten by the Wumpus and falling into Bottomless Pits. 


/usr/games/lib/ddlrun 
/asr/games/lib/aard 
adv.susp 

rogue.save 
/usr/games/lib/rogue_roll 


SEE ALSO 


BUGS 
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net.games.rogue 


You take these games where and as you find them. 


ARITHMETIC ( 6 ) Eighth Edition ARITHMETIC (6) 


NAME 


arithmetic — drill in number facts 


SYNOPSIS 


/usr/games/arithmetic [ +—x/ ] [ range ] 


DESCRIPTION 
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Arithmetic types out simple arithmetic problems, and waits for an answer to be typed in. If the answer is 
correct, it types back ‘Right!’, and a new problem. If the answer is wrong, it replies “What?’, and waits for 
another answer. Every twenty problems, it publishes statistics on correctness and the time required to 
answer. 


To quit the program, type an interrupt (delete). 


The first optional argument determines the kind of problem to be generated; +—x/ respectively cause addi- 
tion, subtraction, multiplication, and division problems to be generated. One or more characters can be 
given; if more than one is given, the different types of problems will be mixed in random order; default is 
+— 


Range is a decimal number; all addends, subtrahends, differences, multiplicands, divisors, and quotients 
will be less than or equal to the value of range. Default range is 10. 


At the start, all numbers less than or equal to range are equally likely to appear. If the respondent makes a 
mistake, the numbers in the problem which was missed become more likely to reappear. 


As a matter of educational philosophy, the program will not give correct answers, since the learner should, 
in principle, be able to calculate them. Thus the program is intended to provide drill for someone just past 
the first learning stage, not to teach number facts de novo. For almost all users, the relevant statistic should 
be time per problem, not percent correct. 


ATC (6) Eighth Edition ATC(6) 


NAME 


atc — air traffic controller 


SYNOPSIS 


/usr/games/atc 


DESCRIPTION 
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Atc presents air traffic on a cursor-controlled screen. As the controller, you must shepherd it safely through 
the air space. At the beginning of the game atc displays the takeoff/landing direction for each airport and 
prompts for the game duration with: 


<> enter a number from 16 simulated minutes (hard) to 99 (easier) 
Options are 
-u=file take airspace description from file 


—a=name 
use the named airspace; default is ‘Apple’ 


—s=seed 
a number for seeding a 32-bit random number generator 


—t=time preset the game duration 
-p=file save the play of the game in the named file 
-m=file play a ‘movie’ of the saved game 


The initial display of a typical airspace looks like this: 


% and # denote airports, * and ! denote navigational aids (navaids), and commas denote airways that link 
entry/exit ‘fixes’, airports, and navaids. Dots are separated by one mile, horizontally, vertically, and diago- 
nally. An airplane appears as a letter followed by its height in thousands of feet. 


There are two kinds of planes: jets flying | mile per tick (15 seconds) and props flying 1/2 mile per tick. 
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You must prevent various misfortunes. Running out of fuel is serious. So is a close encounter — less than 3 
miles horizontal separation at a given altitude. A plane changing altitude is considered to be at both its old 
and new altitudes. A ‘boundary error’, leaving the airspace at the wrong place, not on an airway, or at the 
wrong height, is also serious, but not as likely to be fatal. 


The right side of the screen shows flight plans. A typical flight strip looks like: 
Fj) 7->3 4 NE + 

The first letter is the aircraft ID, the next letter is ‘j’ for jet or ‘p’ for prop. The next field gives the plane’s 
intentions: this one is entering at (or is now at) fix 7 and leaving at fix 3. The origin character tells where 
the plane is (or will be when it enters), the destination is a fix it wishes to go to. (It will, however, continue 
on a straight path unless instructed otherwise.) Next is the altitude, in this case 4000 feet. The bearing is a 
compass direction: N, NE, E, etc. The final character is the amount of fuel left, ‘+’ for more than 10 min- 
utes, otherwise the number of minutes of fuel remaining. Jets begin with 15 minutes of fuel, props 21. 


At the top of the flight plans are listed planes that will appear in the next minute, preceded by how many 
ticks (0-4) they are away. Planes may be cleared for takeoff as soon as they are listed. 


Commands are terminated by <RETURN>. <BACK SPACE> may be used to correct errors. The follow- 
ing kinds of commands can be issued. 


$ End the game (game normally ends after 26 planes) 548349.spOu 
W Print flight plan for airplane W 
XA3 —s X will change altitude to 3000 feet 
QAO = Q will land (go to 0 feet altitude) 
HRE ~~ H will turn right until it is heading east 
ALNW A will turn left until it is heading northwest 
CTS C will turn south through the smallest angle 
T#7 T will take exit bearing for fix 7 at next navaid 
P*% P will take landing bearing for % at next navaid 
DH D will circle (hold) at next navaid 
MRO Abort pending hold, clearance, or turn for plane M 
J? Cancel delayed commands for J 
<SPACE> 

Speed up the game by advancing 15 seconds 


Climbing/descending. Planes climb or descend 1000 feet per mile. Climbing from 0 is a takeoff; descend- 
ing to 0 is a landing. The takeoff/landing direction for each airport is given. A landing airplane must reach 
altitude 0 headed in the right direction 1 mile before the runway. No further commands may be given after 
a descent to 0, as control then rests with the tower. If a plane lands from the wrong direction, it will climb 
to 1000 feet and issue a “go around’ error. While changing altitude, a flight strip reads like 

Dp :—>2 7v3 S 9 
which means at 7000 feet descending to 3000. 


Turning. Planes turn 45 degrees per mile. Turns may be left (L) right (R) or to a specified direction (T). 
Thus ‘ULNE’ tells the pilot of plane U to turn to his left until he is heading northeast. Changes of direction 
are indicated in the flight strip: 

Nj:->5 5 SrW + 
indicates that jet N is heading south, and will turn 90 degrees to the right. To cancel the remaining part of a 
turn, give the command (for plane N) ‘NRO’. 


Navaids. A plane may be directed to turn at a navaid or hold (circle) there, Thus command ‘AH’ holds 
plane A at the next navaid. The flight strip for a plane that is to hold looks like 

Ap:->2 5S* 7 
During the hold, the ‘“*’ will become ‘h’. Every incoming plane that will be landing holds at a navaid 
unless the controller gives it other instructions. 


The command ‘*’ clears a plane to turn sharply to any known fix at the next navaid. The flight strip for a 
plane cleared through a navaid (to fix 5, for example) looks like: 
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Hj .->2 5 S*5 + 
A holding aircraft given a clearance will continue around to the navaid, then immediately assume the 
specified bearing. Turns cancel clearances. 


Delayed commands. Commands of the form 

@<location>,<command>[,<command> ...] 
stack up activities. A location may be any fix or a point offset from a fix, e.g. 

@#sw3s2,ARE 
which means at the point which can be reached by going three miles SW from airport #, then two miles S, 
plane A should begin a right turn until heading E. The information command shows all delayed commands 
pending for that plane. Note that delayed commands allow one to specify actions more than one navaid 
ahead. 
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NAME 
back — backgammon 


SYNOPSIS 
/usr/games/back 


DESCRIPTION 
This program does what you expect. It will ask whether you need instructions. 


Page | 


BANNER (6) Eighth Edition BANNER (6) 


NAME 
banner, rot, rd, bigp — print in large type 


SYNOPSIS 
/usr/games/banner [ —font ] text [ | /usr/games/rot | /usr/games/rnd height width ] 


bigp [ text ] 


DESCRIPTION 
Banner prints its arguments, one per line, in 
# # 
# # 
# Ht #¢ tt Ht # ftH HHtt ft + # tt Het 
# #¢ ## of # Ft # # # # + ## # # # 
# HHtH # # # ##tt # # # # # ttt 
# # # # # # # #+ #¢ # ## # # # Ht 
# #tt = # HHte FTE Ht Ht # #HtH Het Ht 
# # # 
HET #tt  # 


The font may be selected from /usr/jerq/font (see font(9.5)). 

Rot rotates its input clockwise ninety degrees. 
banner Sideways | rot 

runs down the page, and 
banner Upside Down | rot | rot 

is disconcerting. 

Rnd scales the non-white-space characters in its input by integral height and width. 

Bigp generates banners suitable for printing on a line-printer. Its output is approximately the same as 
banner —defont text | rot | md 24. 


If no arguments are supplied, bigp creates a banner from the standard input. 
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NAME 
bed, ppt — convert to antique media 


SYNOPSIS 
/usr/games/bcd text 


/usr/games/ppt 


DESCRIPTION 
Bcd converts the literal text into a form familiar to old-timers. 


Ppt converts the standard input into yet another form. 


SEE ALSO 
dd(1) 
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NAME 


boggle, hangman, scrabble — word games 


SYNOPSIS 


/usr/games/boggle [ + ] [ ++ ] [ word word word word ] 


/usr/games/hangman [ arg | 


DESCRIPTION 


FILES 


BUGS 
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Boggle provides practice for the Parker Brothers game. If invoked with 4 arguments of 4 letters each, the 
program forms the obvious Boggle grid and lists all the words from /usr/dict/words found therein. If 
invoked without arguments, it will generate a board, let you enter words for 3 minutes, and then tell how 
well you did relative to /usr/dict/words. Words may be formed from any sequence of 3 or more adjacent 
letters in the grid. Letters may join horizontally, vertically, or diagonally. However, no position in the grid 
may be used more than once within any one word. In competitive play amongst humans, each player is 
given credit for those of his words which no other player has found. 


Enter your words separated by spaces, tabs, or newlines. A bell will ring when there is 2:00, 1:00, 0:10, 
0:02, 0:01, and 0:00 time left. You may complete any word started before the expiration of time. You can 
surrender before time is up by hitting interrrupt. While entering words, your erase character is only effec- 
tive within the current word and your line kill character is ignored. 


Option + removes the restriction that positions can only be used once in each word. Option ++ causes a 
position to be considered adjacent to itself as well as to its (at most) 8 neighbors. 


Scrabble plays the Selchow and Righter game on a cursor-addressed terminal against a single opponent. 
To place a letter first move the cursor by typing 2, 4, 6, 8 for down, left, right, up respectively (1, 3, 7, 9 are 
diagonals) then type the letter in place. Type ‘?’ to cycle through a set of helpfule tables. 


Hangman chooses a word at least seven letters long from a dictionary. You then guess letters one at a time. 


The optional argument arg names an alternate dictionary. The special name ‘—a’ gets a particular very large 
dictionary. 


/usr/dict/words 
/usr/dict/web2 alternate dictionary for hangman 


Hangman runs hyphenated compounds together. 
Scrabble rubs in its brilliance with merciless play and an inhumane interface. 


BRIDGE (6) Eighth Edition (alice) BRIDGE(6) 


NAME 


bridge — card game 


SYNOPSIS 


/usr/games/bridge [ arg ] ... 


DESCRIPTION 


FILES 


Bridge manages bridge games among four players. A master process mediates the flow of information 
between player processes. Each player process is either a ‘robot’ player or a cursor-controlled screen inter- 
face with a human player. 


If several humans wish to play each invokes bridge and a rendezvous protocol hooks them together in a 
common game. Once the game is set up bridge displays a diagram similar to those in newspaper bridge 
columns. 


Bids are coded p for pass, d for double, 3n for three notrump, and so on. Plays are coded ¢3 for the club 
three, ht for the heart ten, and so on. A menu of common commands appears at the bottom of the screen; 
further help may be obtained by typing +. 


Arguments take several forms: 


—h nhumans 
humans=nhumans 
Join (or set up and join) a game with indicated number of human players. 
-s seed 
seed=seed 
Initialize the random number generator. Useful for duplicate play. 
-f file 
deck=/file 
Take the initial shuffled card deck from named file. 
-r file 
script=file 
Make a record of the game in the named file. 
-d dealership 
dir=dealership 
Specify dealership with a one-letter direction code. 
—v vulnerability 
vuln=vulnerability 
Specify vulnerability with one of these codes: none both n-s e-w. 
-t 
tough Do not display bidding history on player’s screen. 


/tmp/nbridgez* rendezvous file for robots 
/tmp/mbridgey*rendezvous file for humans 
/tmp/mbridge* temporary lock file 

/dev/pt/pt* interprocess communication 
/etc/termcap 

DEBUG recipient of debugging messages 


SEE ALSO 


BUGS 
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J. A. Reeds and L. A. Shepp, Bridge: An exciting new card game, TM 11217-840119-02, TM 11218- 
840119-01. 


Occasionally the whole program goes dead. 
The robots’ bridge technique has subtle bugs. 
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NAME 
canfield, cribbage, fish — card games 
SYNOPSIS 
/usr/games/cribbage [ —-req ] name ... 
/usr/games/fish 
DESCRIPTION 
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Cribbage plays the card game. The program may print the rules according to Hoyle using more; see p(1). 


The options are: 


-e When the player makes a mistakes scoring his hand or crib, provide an explanation of the correct 
score. 

-q Print a shorter form of all messages. 

-r Instead of asking the player to cut the deck, the program will randomly cut the deck. 


When asked to cut the deck, answer with a number indicating how many cards down the deck is to be cut. 
A carriage return when numeric input is expected means the lowest legal value; when cutting the deck this 
is equivalent to choosing the top card. 


Cards are specified as rank followed by suit, either spelled out, or abbreviated as in ‘ac’, ‘8d’, ‘th’, ‘js’. 


The object of the children’s card game fish is to accumulate ‘books’ of 4 cards of equal rank. At each turn 
one player selects a card from his hand, and asks the other player for all cards of that rank. If the other 
player has some, he hands them all over and the first player makes another request. The turn ends when the 
second player has no card of the rank requested; he replies “GO FISH!’ The first player then draws a card 
from the ‘pool’ of undealt cards. If this is the card he had last requested, he draws again. 


The ranks are called ‘a’, *2’, ..., ‘10’, ‘j’, ‘q’, ‘k’. Hitting return requests information about the state of the 
game. Typing ‘p’ as a first guess gets ‘pro’ level play. 


Canfield is a solitaire game. It requires a cursor-addressed terminal. 
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NAME 


ching — the book of changes 


SYNOPSIS 


/usr/games/ching [ hexagram ] 


DESCRIPTION 


The J Ching or Book of Changes is an ancient Chinese oracle that has been in use for centuries as a source 
of wisdom and advice. 


The text of the oracle (as it is sometimes known) consists of sixty-four hexagrams, each symbolized by a 
particular arrangement of six straight (——) and broken (— —) lines. These lines have values ranging from 
six through nine, with the even values indicating the broken lines. 


Each hexagram consists of two major sections. The Judgement relates specifically to the matter at hand 
(E.g., ‘It furthers one to have somewhere to go.’) while the Image describes the general attributes of the 
hexagram and how they apply to one’s own life (‘Thus the superior man makes himself strong and untir- 
ing.’). 

When any of the lines have the values six or nine, they are moving lines; for each there is an appended 
judgement which becomes significant. Furthermore, the moving lines are inherently unstable and change 
into their opposites; a second hexagram (and thus an additional judgement) is formed. 


Normally, one consults the oracle by fixing the desired question firmly in mind and then casting a set of 
changes (lines) using yarrow-stalks or tossed coins. The resulting hexagram will be the answer to the ques- 
tion. 


Using an algorithm suggested by S. C. Johnson, the Unix oracle simply reads a question from the standard 
input (up to an EOF) and hashes the individual characters in combination with the time of day, process id 
and any other magic numbers which happen to be lying around the system. The resulting value is used as 
the seed of a random number generator which drives a simulated coin—toss divination. The answer is then 
piped through nroff for formatting and will appear on the standard output. 


For those who wish to remain steadfast in the old traditions, the oracle will also accept the results of a per- 
sonal divination using, for example, coins. To do this, cast the change and then type the resulting line val- 
ues as an argument. 


The impatient modern may prefer to settle for Chinese cookies; try fortune (1). 


SEE ALSO 


It furthers one to see the great man. 


DIAGNOSTICS 


BUGS 
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The great prince issues commands, 
Founds states, vests families with fiefs. 
Inferior people should not be employed. 


Waiting in the mud 
Brings about the arrival of the enemy. 


If one is not extremely careful, 
Somebody may come up from behind and strike him. 
Misfortune. 
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NAME 
doctor, tso — psychiatric consultation 


SYNOPSIS 
/usr/games/doctor 


/usr/games/tso 


DESCRIPTION 
Doctor will understandingly explore most anything with you. Just type your thoughts followed by double 
carriage returns. 


Tso, on the other hand, has a will of its own. 
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NAME 

fortune — cookies 
SYNOPSIS 

fortune [ file ] 

say[N ] 
DESCRIPTION 


Fortune prints a one-line aphorism chosen at random. If a file is specified, the sayings are taken from that 
file; otherwise they are selected from /usr/games/lib/fortunes. 


Say constructs N proverbs out of old parts. N=1 by default. 


FILES 
/usr/games/lib/fortunes — sayings 
/usr/games/lib/fortunes.index — fast lookup table, maintained automatically 
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NAME 
mars — memory array redcode simulator 


SYNOPSIS 
mars [-dfhmp] [-cqs<value>] file file2 ... 


DESCRIPTION 
Mars is a simulator for the Redcode machine specified by Dr. Kee Dewdney in the "Computer Recreations" 
column in the May 1984 issue of Scientific American. The command line contains any arguments followed 
by a list of object code file names. The easiest way to create an object file is to use the redcode(6) com- 
mand to a assemble the object file from a redcode source file. 


OBJECT FILES 
An object file contains three header lines indicating the name of the program, the length of the program, and 
the offset from the beginning of the starting location. Here is a sample redcode object file, for the Dwarf 
program: 


name dwarf 
length 4 

start 1 
00000007999 
20000517999 
10000027998 
41799800000 


INSTRUCTION FORMAT 
The instruction format is an 11 digit decimal string, as follows: 


0 1 2-5 6 7-10 
+------- +------- +------- +------- +------- + 

| opcode | model larg] | mode2 | arg2 | 
+------- +------- +------- +------- +------- + 


OPTIONS 
Options allow for tracing execution, for graphically displaying the progress of each program, and for ana- 
lyzing and dumping memory before and after execution. For example, the following command: 


mars -s1234 -f -c20000 dwarf.obj gemini.obj imp.obj 


specifies that imp, dwarf, and gemini are to be run together, with a fullscreen display for 20000 cycles using 
a random number seed of 1234. 


-cN cycles option, determines the maximum number of cycles for this run. The default is 10000. 

-d debug option, causes the execution to be traced in excrutiating detail. 

-f fullscreen option, causes the execution to be displayed graphically on any terminal supported by 
curses (3). 

-h holes option, causes a description of memory usage to be printed after execution terminates. 

-m memory dump option, causes memory to be dumped before and after execution terminates. 

-p procedure dump option, similar to -m option, except only memory near each program counter is 
dumped. 

-qN quit option, indicates the minimum number of programs required to be alive. For example, if -q3 


is specified, execution terminates as soon as there are fewer than three programs still alive. -q1 
specifies that execution continues as long as any program is alive. The default is to quit when 
there is but one program still running. 


Page | 


MARS (6) Eighth Edition (5/20/84) MARS (6) 


-sN random seed option, specifies a random seed for this run. The default is 0 (i.e. a random seed 
based on the time). 


SEE ALSO 
redcode(6) 


BUGS 
None known. 


HISTORY 
20-May-84 Michael Mauldin (mlm) at CMU 
Created. 
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NAME 


DESCRIPTION 


CARDS 
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mille — card game 


SYNOPSIS 
/usr/games/mille [ file ] 


Mille plays a two-handed game reminiscent of the Parker Brother’s game of Mille Bournes with you. The 
rules are described below. If a file name is given on the command line, the game saved in that file is 


started. 


When a game is started up, the bottom of the score window will contain a list of commands. They are: 


P 
D 


Pick a card from the deck. This card is placed in the ‘P’ slot in your hand. 


Discard a card from your hand. To indicate which card, type the number of the card in the hand 
(or ‘P’ for the just-picked card) followed by a <RETURN> or <SPACE>. The <RETURN or 
<SPACE> is required to allow recovery from typos which can be very expensive, like discarding 
safeties. 


Use a card. The card is again indicated by its number, followed by a<RETURN> or <SPACE>. 


Toggle ordering the hand. By default off, if turned on it will sort the cards in your hand appropri- 
ately. This is not recommended for the impatient on slow terminals. 


Quit the game. This will ask for confirmation, just to be sure. Hitting <DELETE> (or 
<RUBOUTS) is equivalent. 


Save the game in a file. If the game was started from a file, you will be given an opportunity to 
save it on the same file. If you don’t wish to, or you did not start from a file, you will be asked for 
the file name. If you type a<RETURN> without a name, the save will be terminated and the game 
resumed. 


Redraw the screen from scratch. The command “L (control ‘L’) will also work. 


Toggle window type. This switches the score window between the startup window (with all the 
command names) and the end-of-game window. Using the end-of-game window saves time by 
eliminating the switch at the end of the game to show the final score. Recommended for hackers 
and other miscreants. 


If you make a mistake, an error message will be printed on the last line of the score window, and a bell will 


beep. 


At the end of each hand or game, you will be asked if you wish to play another. If not, it will ask you if 
you want to save the game. If you do, and the save is unsuccessful, play will be resumed as if you had said 
you wanted to play another hand/game. This allows you to use the ‘S’ command to reattempt the save. 


AUTHOR 
Ken Arnold 
(The game itself is a product of Parker Brothers, Inc.) 


SEE ALSO 
curses(3), Screen Updating and Cursor Movement Optimization: A Library Package, Ken Arnold 


Here is some useful information. The number in parentheses after the card name is the number of that card 
in the deck: 
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RULES 


Hazard Repair Safety 

Out of Gas (2) Gasoline (6) Extra Tank (1) 
Flat Tire (2) Spare Tire (6) Puncture Proof (1) 
Accident (2) Repairs (6) Driving Ace (1) 
Stop (4) Go (14) Right of Way (1) 


Speed Limit (3) — End of Limit (6) 


25 — (10), 50 — (10), 75 — (10), 100 — (12), 200 — (4) 


Object: The point of game is to get a total of 5000 points in several hands. Each hand is a race to put down 
exactly 700 miles before your opponent does. Beyond the points gained by putting down milestones, there 
are several other ways of making points. 


Overview: The game is played with a deck of 101 cards. Distance cards represent a number of miles trav- 
eled. They come in denominations of 25, 50, 75, 100, and 200. When one is played, it adds that many 
miles to the player’s trip so far this hand. Hazard cards are used to prevent your opponent from putting 
down Distance cards. They can only be played if your opponent has a Go card on top of the Battle pile. 
The cards are Out of Gas, Accident, Flat Tire, Speed Limit, and Stop. Remedy cards fix problems caused 
by Hazard cards played on you by your opponent. The cards are Gasoline, Repairs, Spare Tire, End of 
Limit, and Go. Safety cards prevent your opponent from putting specific Hazard cards on you in the first 
place. They are Extra Tank, Driving Ace, Puncture Proof, and Right of Way, and there are only one of 
each in the deck. 


Board Layout: The board is split into several areas. From top to bottom, they are: SAFETY AREA (unla- 
beled): This is where the safeties will be placed as they are played. HAND: These are the cards in your 
hand. BATTLE: This is the Battle pile. All the Hazard and Remedy Cards are played here, except the 
Speed Limit and End of Limit cards. Only the top card is displayed, as it is the only effective one. SPEED: 
The Speed pile. The Speed Limit and End of Limit cards are played here to control the speed at which the 
player is allowed to put down miles. MILEAGE: Miles are placed here. The total of the numbers shown 
here is the distance traveled so far. 


Play: The first pick alternates between the two players. Each turn usually starts with a pick from the deck. 
The player then plays a card, or if this is not possible or desirable, discards one. Normally, a play or dis- 
card of a single card constitutes a turn. If the card played is a safety, however, the same player takes 
another turn immediately. 


This repeats until one of the players reaches 700 points or the deck runs out. If someone reaces 700, they 
have the option of going for an Extension, which means that the play continues until someone reaches 1000 
miles. 


Hazard and Remedy Cards: Hazard Cards are played on your opponent’s Battle and Speed piles. Rem- 
edy Cards are used for undoing the effects of your opponent’s nastyness. 


Go (Green Light) must be the top card on your Battle pile for you to play any mileage, unless you have 
played the Right of Way card (see below). 

Stop is played on your opponent’s Go card to prevent them from playing mileage until they play a Go 
card. 

Speed Limit is played on your opponent’s Speed pile. Until they play an End of Limit they can only 
play 25 or 50 mile cards, presuming their Go card allows them to do even that. 

End of Limit is played on your Speed pile to nullify a Speed Limit played by your opponent. 

Out of Gas is played on your opponent’s Go card. They must then play a Gasoline card, and then a Go 
card before they can play any more mileage. 

Flat Tire is played on your opponent’s Go card. They must then play a Spare Tire card, and then a Go 
card before they can play any more mileage. 

Accident is played on your opponent’s Go card. They must then play a Repairs card, and then a Go card 
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before they can play any more mileage. 


Safety Cards: Safety cards prevent your opponent from playing the corresponding Hazard cards on you for 
the rest of the hand. It cancels an attack in progress, and always entitles the player to an extra turn. 

Right of Way prevents your opponent from playing both Stop and Speed Limit cards on you. It also acts 
as a permanent Go card for the rest of the hand, so you can play mileage as long as there is not a Hazard 
card on top of your Battle pile. In this case only, your opponent can play Hazard cards directly on a Rem- 
edy card besides a Go card. 

Extra Tank When played, your opponent cannot play an Out of Gas on your Battle Pile. 

Puncture Proof When played, your opponent cannot play a Flat Tire on your Battle Pile. 

Driving Ace When played, your opponent cannot play an Accident on your Battle Pile. 


Distance Cards: Distance cards are played when you have a Go card on your Battle pile, or a Right of Way 
in your Safety area and are not stopped by a Hazard Card. They can be played in any combination that 
totals exactly 700 miles, except that you cannot play more than two 200 mile cards in one hand. A hand 
ends whenever one player gets exactly 700 miles or the deck runs out. In that case, play continues until nei- 
ther someone reaches 700, or neither player can use any cards in their hand. If the trip is completed after 
the deck runs out, this is called Delayed Action. 


Coup Fourré: This is a French fencing term for a counter-thrust move as part of a parry to an opponents 
attack. In Mille Bournes, it is used as follows: If an opponent plays a Hazard card, and you have the corre- 
sponding Safety in your hand, you play it immediately, even before you draw. This immediately removes 
the Hazard card from your Battle pile, and protects you from that card for the rest of the game. This gives 
you more points (see ‘Scoring’ below). 


Scoring: Scores are totaled at the end of each hand, whether or not anyone completed the trip. The terms 
used in the Score window have the following meanings: 

Milestones Played: Each player scores as many miles as they played before the trip ended. 

Each Safety: 100 points for each safety in the Safety area. 

All 4 Safeties: 300 points if all four safeties are played. 

Each Coup Fouré: 300 points for each Coup Fouré accomplished. 


The following bonus scores can apply only to the winning player. 
Trip Completed: 400 points bonus for completing the trip to 700 or 1000. 
Safe Trip: 300 points bonus for completing the trip without using any 200 mile cards. 
Delayed Action: 300 points bonus for finishing after the deck was exhausted. 
Extension: 200 points bonus for completing a 1000 mile trip. 
Shut-Out: 500 points bonus for completing the trip before your opponent played any mileage cards. 


Running totals are also kept for the current score for each player for the hand (Hand Total), the game 
(Overall Total), and number of games won (Games). 
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NAME 


ogre — war game 


SYNOPSIS 


/usr/games/ogre [ogre type (3 or 5)] 


DESCRIPTION 
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Ogre is a game of tank warfare in the 21st century. You command a force of infantry, armor, and howitzers 
pitted against a giant cybernetic tank, the Ogre. Your mission is to destroy the Ogre, or at least render it 
immobile, before it reaches and destroys your command post. 


A more complete reference on how to play can be found in the Ogre rule book for the Metagaming 
MicroGame, now distributed by Steve Jackson’s company. Here’s some very sketchy and incomplete doc- 
umentation for Ogre players: 


The game has the following phases: 


1) Initialization. The player’s armor units, infantry, and command post are placed on the map. Nothing can 
be placed on the leftmost 7 columns of hexes, or on craters (*’s), or on any unit already placed. Valid com- 
mands are: 


a d (hex movement keys) 
ZX 
place a: 


H_ howitzer 

T heavy tank 

M missile tank 

G GEV 

I Infantry unit (attack strength 3) 
C Command Post 


on the space currently pointed at by the cursor. Note that these are capital letters. 


Units are displayed as these characters, except infantry, which appear as °1’, ’2’, or °3’ depending on their 
attack strength. 


2) The Ogre (an O) now appears. 


3) You are given the opportunity to move all your vehicles and infantry that can move. The cursor motion 
keys are used to move the unit indicated by the cursor. Additionally, ’s’ or’ ’ can be used to let a vehicle 
stay motionless. No vehicle can move through a crater hex, or into a hex occupied by another friendly unit 
on its last turn, although it can move through a friendly hex on its way elsewhere. Moving through the hex 
occupied by the Ogre is an attempt to ram the Ogre. This reduces the Ogre’s treads by some amount, and 
destroys the unit. 


4) You now fire all your vehicles in range at designated targets on the Ogre. The following commands are 
used: 


m fire at missiles 

b fire at main batteries 

Ss fire at secondary batteries 
a fire at anti-personnel guns 
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t fire at treads 


The odds of destroying the target are displayed, but no action is taken until ’r’ is used, or until you run out 
of attack points (except for attacks on treads — see below). (In the odds display, ’+’ means a sure thing.) 


p Pass. The unit is passed over, and given the opportunity to fire later. 


r resolve all allocations so far, and display the results. This is implied by ’t’, as tread attacks cannot 
be grouped. A resolve is done automatically when you run out of attacking units. 


5) Second movement phase for GEVs. Just like step 3, except that only GEVs can move. 
6) The Ogre moves. If it runs over any of your units, they are damaged or destroyed. 


7) The Ogre fires at all units in range. Destroyed units are removed from the map. Disabled units are dis- 
played in lower case, and may not move or fire until the end of the NEXT Ogre attack. 


Steps 3 through 7 are repeated until either a) the Ogre has no movement points left, in which case you win, 
or b) your command post is destroyed, in which case the Ogre wins. 


MISCELLANEOUS 
The display "a/r Dd Mm" means the unit concerned attacks at a, at range r, defends at d, and moves m 
hexes per turn. 


The Ogre by default is a Mark HI. An argument of ’5’ on the command line makes it a Mark V, and gives 
you more armor points. 


The game can be interrupted at any point with a control-C. There’s now no way to restart. 


The paper game is copyright (c) 1977 by Steve Jackson. This computer implementation is copyright (c) 
1984 by Michael Caplinger. 


AUTHOR 
Michael Caplinger, Rice University (mike @rice.ARPA), from a Microgame of the same name published by 
Metagaming of Austin, Texas, and written by Steve Jackson. This implementation is not authorized in any 
way by Mr. Jackson, and should not be sold for profit. 


SEE ALSO 
termcap(5) 


BUGS 
The Ogre sometimes gets confused and doesn’t know where to go, so it oscillates from one hex to another, 
and then back. 
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NAME 
quiz — test your knowledge 
SYNOPSIS 
/usr/games/quiz [ -i file ] [ -t ] | category1 category? ] 
DESCRIPTION 
Quiz gives associative knowledge tests on various subjects. It asks items chosen from categoryl and 
expects answers from category2. If no categories are specified, quiz gives instructions and lists the avail- 
able categories. 
Quiz tells a correct answer whenever you type a bare newline. At the end of input, upon interrupt, or when 
questions run out, quiz reports a score and terminates. 
The -t flag specifies ‘tutorial’ mode, where missed questions are repeated later, and material is gradually 
introduced as you learn. 
The -i flag causes the named file to be substituted for the default index file. The lines of these files have the 
syntax: 
line = category newline | category ‘:’ line 
category = alternate | category * |’ alternate 
alternate = empty | alternate primary 
primary = character lay category ‘]’ | option 
option = ‘{’ category ‘}’ 
The first category on each line of an index file names an information file. The remaining categories specify 
the order and contents of the data in each line of the information file. Information files have the same syn- 
tax. Backslash ‘\’ is used as with sh(1) to quote syntactically significant characters or to insert transparent 
newlines into a line. When either a question or its answer is empty, quiz will refrain from asking it. 
FILES 
/usr/games/quiz.k/* 
BUGS 


The construct ‘al ab’ doesn’t work in an information file. Use ‘a{b}’. 
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NAME 

redcode — assembler for mars game 
SYNOPSIS 

redcode file! file2 ... 
DESCRIPTION 


Redcode is an assembler for the Redcode assembly language specified by Dr. Kee Dewdney in the "Com- 
puter Recreations” column in the May 1984 issue of Scientific American. The command line contains a list 
of source file names (including the extension ".red") to be assembled. The result is a corresponding number 
of object files with extension ".obj". For example, the following command: 


redcode dwarf.red gemini.red imp.red 


would assemble these three programs and create files dwarf:obj gemini.obj imp.obj. 


SOURCE FILES 
A source file consists of a name directive which specifies the program’s name, followed by any number of 
program and data statements, followed by an end directive which specifies the starting location of the pro- 
gram. Statements have the following syntax: 


[label] opcode arg1 [arg2] [; comment] 


ADDRESSING MODES 
There are three addressing modes; all address calculations are done modulo 8000. 


Syntax Meaning 

#[0-9]+ immediate 

[0-9]+ relative 

@[0-9]+ indirect, relative 
OPCODES 

The following opcodes are implemented, along with the corresponding semantics specified in pseudo-C: 

Instruction Mnem Opcode Args — Explanation 

Move mov 1 AB B=A 

Add add 2 AB Bt=A 

Subtract sub 3 AB B-=A 

Jump jmp 4 A PC=A 

Jump if zero jmz 5 AB PC=(B==0)?A:PC+1 

Jump if greater jmg 6 AB PC=(B<4000)?A:PC+1 

Dec, Jmp if 0 djz 7 AB PC=(--B==0)?A:PC+1 

Compare cmp 8 AB PC=(A==B)?PC+1:PC+2 
PSEUDO-OPS 


The following non-executable directives may be used to reserve and initialize data space: 


Directive Mnem_ Arg Explanation 

Buffer space bss n Reserve n words 

Data data A Initialize 1 word 

Name name ’t’ Name of program 

End end start Specify starting location 


A SAMPLE REDCODE PROGRAM 


999999999999999999999999999999999999999999999999999999%"°" 


33; Dwarf, a sample Redcode program 
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name ‘dwarf’ 


site data -1 ; address of last 0 *bomb’ 
start add #5 site ; move site forward 

mov #0 @site ; write O bomb’ 

jmp start ; loop 

end start 


OBJECT FILES 
For documentation on the object code format, see mars (6). 


SEE ALSO 
mars(6) 


HISTORY 
20-May-84 Paul Milazzo (milazzo) at RICE 
Created. 
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NAME 


snake, worm — display chase games 


SYNOPSIS 


/usr/games/snake 


/usr/games/worm 


DESCRIPTION 
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Snake must be played on a HP2621 terminal or equivalent. The object of the game is to make as much 
money as possible without getting eaten by the snake. 


You are represented on the screen by an I. The snake is 6 squares long and is represented by S’s. The 
money is $, and an exit is #. Your score is posted in the upper left hand corner. 


You can move around using h, j, k, and | keys for left, up, down, and right. To earn money, move to the 
same square the money is on. A new $ will appear when you earn the current one. As you get richer, the 
snake gets hungrier. To leave the game, move to the exit (#). a 


Worm also requires a 2621-compatible terminal. Once started, with h, j, k, 1 keys as for snake, the worm 
moves forward unless directed otherwise. The object is to collect points displayed on the screen without 
running into the wall or any part of the worm itself. The points are added to the worms length. 
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NAME 
trek, ogre, sol, warp, sail — war games 


SYNOPSIS 
/usr/games/trek [ [ —a ] file ] 


/usr/games/ogre 
/usr/games/sol 
/usr/games/warp 
/usr/games/sail 


DESCRIPTION 
Trek is a classic sci-fi game for a dumb terminal. For instructions, respond ‘?’ to any question. See the ref- 
erence for details. 


If a file is named, a log of the game is written onto that file. Option —a causes the file to be appended to, not 
truncated. 


Sol and warp are other space-war games; they volunteer instructions. 
Ogre is a tank-war game. It needs a cursor-addressed terminal. For instructions, see ogre (6) on line. 


Sail allows one or more players to con a ship of the line through battle. It requires a cursor addressed termi- 
nal. See the reference for details. 


SEE ALSO 
/n/bowell/src/doc/trek 
/usr/man/man6/ogre.6 
/n/bowell/src/doc/sail 
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NAME 
worms, hanoi, rain — silly demos 


SYNOPSIS 
/usr/games/worms 


/usr/games/hanoi 
/usr/games/rain 


DESCRIPTION 
These games draw various moving patterns on a cursor-addressed terminal. 
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NAME 


apnews, ap.keys — present AP wire stories 


SYNOPSIS 


apnews [ -f dir ] [-r ] 


DESCRIPTION 
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Apnews presents news from the AP wire on a video screen. The top half of the screen contains 20 story 
slugs (two-word labels). Apnews responds to these commands: 


n print story for slug n; page through it by typing newlines 


m present more slugs 

. return to current slug list 
t return to first list 

s keywords 


present slugs for stories containing these keywords 
y present slugs for stories containing words from the last story read 
c file (copy) add story being read to named file or directory 
? print some help 


To suggest interest, slugs may be followed by a bracketed number that shows the average number of pages 
(up to 5) that readers have perused. Option —r turns this feature off. 


Option -f directs the attention of apnews to a specified directory of AP stories, as may be collected by 
ap.keys. 


To monitor news automatically, put a file ap.keys in your home directory. This file contains instruction 
lines marked by stars (*), each followed by one or more search lines. Instructions specify how much to 
capture: 


S whole story 
Pp first paragraph 
H heading 


then what to do with it: 


| command 
specifying a command (often mail) to be executed with the story as standard input 


> file specifying a file or directory to add the story to; pathnames are relative to your home directory 
If no instruction is present, the default is 
*§ | mail yourself 
Search lines may contain: 
- a sequence of blank-separated words; these words must occur in this order 
- a sequence of words separated by commas; these words must appear in the same sentence 


- a sequence of words separated by periods; these words may occur anywhere in the story, but all 
must appear 


Combinations are allowed, e.g. x. y, z specifies y and z in the same sentence and x somewhere in the same 
story. The character “!’ means not, so that /chocolate chip means chip not preceded by chocolate. Some 
suffixes are removed; and capitals are ignored except when entire words are capitalized. Thus ERA and era 
are distinguished, but Waters and waters are not. Special ‘words’ specify story types: 


#f flash 
#b bulletin 
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#u urgent news 

#1 regular news 

#d deferred news 
EXAMPLE 

*S > stuff 


bell laboratories 

FCC . telephone, regulation 
*P | mail joe 

#b 

AM-NewsDigest 


FILES 
/ustr/spool/ap/* 
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NAME 


DESCRIPTION 


FILES 
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ascii — map of ASCII character set 


SYNOPSIS 
cat /usr/pub/ascii 


Eighth Edition 


Ascii is a map of the ASCII character set, to be printed as needed. It contains: 


1000 nul |001 
1010 bs |O11 
1020 dle|021 
1030 can|031 
1040 sp 1041 
1050 ( 1051 
1060 0 |061 
1070 +8 |071 
1100 @ |101 
1110 H l111 
1120 P |121 
1130 X |131 
1140 > [141 
1150 h {151 
1160 p |161 
1170 x |171 
| 00 null O1 
| 08 bs | 09 
| 10 dle| 11 
| 18 can| 19 
| 20 sp | 21 
| 28 (¢ | 29 
| 30 0 | 31 
| 38 8 | 39 
| 40 @| 41 
| 48 H| 49 
| 50 P| 51 
| 58 x | 59 
| 60 ~ | 61 
| 68 h | 69 
| 70 p | 71 
| 78 x | 79 
/usr/pub/ascii 


soh| 002 
ht |012 
dc1|022 
em 1032 

1 1042 
1052 
|062 
1072 
1102 
| 112 
(12% 
| 132 
| 142 
1152 
1162 
1172 


“WH Oe KOH POY 


soh| 02 
ht | Oa 
del] 12 
| la 
[<9 
| 2a 
| 32 
| 3a 
| 42 
| 4a 
| 52 
| 5a 
| 62 
| 6a 
Ree 
| Ta 


stx|003 
nl 1013 
dc2|023 
sub |033 
" 1043 
« |053 
2 1063 
1073 
B 1103 
J 1113 
R 1123 
Z 1133 
b 1143 
j 
Tt 
Z 


etx|004 
vt 1014 
dc3|024 
esc| 034 


+ 


wt 


nan FamTNnAN:: 


etx| 
vt | 
dc3| 
esc | 
# 


wt 


nan Fam nAN:,: 


1044 
|054 
| 064 
1074 
1104 
1114 
1124 
1134 
1144 
1154 
1164 
1174 


04 
Oc 
14 
lc 
24 
2c 
34 
3c 
44 
4c 
54 
Sc 
64 
6c 
74 
Tc 


eot |005 
np |015 
dc4|025 


fs 
$ 


—r7rPaAa-HOrOUA #- 


—eraAae-HOrOA Ye 


enq|006 
cr |016 
nak|026 
gs |036 
1046 
1056 
|066 
|076 
| 106 
1116 
1126 
1136 
1146 
1156 
| 166 
1176 


x 


~se Bor Cemiwl 


~s Bor CZmi wi 


ack|007 bel| 
so |017 si | 
syn|027 etb| 
rs 1037 us 
& |047 ” 
1057. / 
|067 7 
1077. 2 
1107 G 
1117. O 
|127 W 
[137 
1147 g 
1157 o 

WwW 


><A AmMvVva-: 


tC< BB Rh 
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NAME 
candest — canon laser printers 
DESCRIPTION 
The names of Canon laser printers, usable in the —-d option of can(1) or as the value of environment vari- 
able CANDEST are: 
3 3rd floor, end of 9S corridor (mrkos) 
4 4th floor, stair 8 (ikeya) 
8 3rd floor, stair 8 (tukey) 
9 4th floor, stair 9 (wild) 
j jones room (jones) 
u unix room (panther) 


/{name] printer on Datakit machine path (name) 
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NAME 
dict — look up words in English dictionaries 


SYNOPSIS 
dict [ -p ] [ dictionary [ word ] ] 


DESCRIPTION 
Dict looks up words in the specified dictionary. Words are read, one per line from the standard input, and 
entries are written on the standard output. Characters other than letters, digits, and space are ignored. If 
just one word is to be looked up, it may be given as an argument. Dictionary is one of 559360.sp48u 
webster Merriam-Webster Collegiate Dictionary, Seventh Edition, full text (default) 


web7 same, words only 


etym[ology] 
inverted index to ‘webster’ by root words 


web2 Merriam-Webster New International Dictionary, Second Edition, unabridged, words only 
oxford The Oxford Advanced Learner’s Dictionary of Contemporary English, full text 
spell _—_ word list of spell(1) 


acro[nym] 
17000 AT&T acronyms 


Option —p finds all entries of which the specified ‘word’ is a prefix. This option is ignored for full-text dic- 
tionaries. 


The dictionaries for webster, oxford, web7 and etymology are copyrighted and should not be copied without 
permission. 


FILES 
/usr1/dict/w7full/* 
/usr1/dict/w7etym 
/asr1/dict/web2 
/usr1/dict/oaldce/* 
/usr/dict/words spell or web7, depending on machine 
/asr1/dict/acro 


SEE ALSO 
look(1) 


BUGS 
In some of the dictionaries, diacriticals are done right — by overstrikes, with which few screen terminals can 
cope. 
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tdefine ciplus % "®" % ndefine ciplus % O+ % tdefine citimes % "®" % ndefine citimes % Ok % tdefine =wig % "=" 
% ndefine =wig % =""" % tdefine bigstar % "x" % ndefine bigstar % Xt % tdefine =dot % "=" % ndefine =dot % = 
dot % tdefine orsign % "V" % ndefine orsign % V % tdefine andsign % "A" % ndefine andsign % / % tdefine =del % 
"A" % ndefine =del % = to DELTA % tdefine oppA % "V' % ndefine oppA % V. % tdefine oppE %"=!' % ndefine 
oppE % H % tdefine incl % "[_" % ndefine incl % C_ % tdefine nomem % "é" % ndefine nomem % G % tdefine 
angstrom % ' Py is ndefine angstrom % A to o % tdefine star %{ roman "."}% ndefine star % * % tdefine || % || % 
tdefine <wig % "<" % ndefine <wig %{ < from "" }% tdefine >wig % ">" % ndefine >wig %{ > from """ }% 
tdefine langle % fc " % ndefine langle %<% tdefine rangle % ie % ndefine rangle %>% tdefine hbar % "h" % ndefine 
hbar % h % adeane ppd % ‘| % tdefine ppd % "|" % tdlefine: <-> % "o>" % ndefine <-> % "<-->" % tdefine <=> % 

"<x" % ndefine <=> % "<=>" % tdefine |< % "+" % ndefine |< % <4 % tdefine |> % "$" % ndefine |> % b % 
tdefine ang % "/"" % ndefine ang % / % tdefine xe % "|_" % ndefine rang % L % tdefine ak % "-" % ndefine 3dot 
% : % tdefine thf % "."." % ndefine thf % .: % tdefine quarter % roman “4 % ndefine quarter % 1/4 % tdefine 3quarter 
% roman % % ndefine 3quarter % 3/4 % tdefine degree % ° % ndefine degree % nothing sup o % tdefine square % 
% ndefine square % [] % tdefine circle % © % ndefine circle % O % tdefine blot % "CI" % ndefine blot % HX % 
tdefine bullet % © % ndefine bullet % oe % tdefine -wig % "=" % ndefine -wig % - to '""" % tdefine wig % ~ % 
ndefine wig % "~" % tdefine prop % « % ndefine prop % oc % tdefine empty % © % ndefine empty % O' % tdefine 
member % € % ndefine member % G % tdefine cup % U % ndefine cup % U % define cap % M % define subset % 
Cc % define supset % > % define !subset % C % define !supset % D % 
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EQNCHAR (7) 


NAME 


Eighth Edition 


eqnchar — special character definitions for eqn 


SYNOPSIS 
eqn /usr/pub/eqnchar [ files | | troff [ options ] 


neqn /usr/pub/eqnchar [ files | | nroff [ options ] 
DESCRIPTION 


Egqnchar contains troff and nroff character definitions for constructing characters that are not available on 
the Graphic Systems typesetter. These definitions are primarily intended for use with eqn and neqn. It con- 


tains definitions for the following characters 


"ciplus" ciplus 
"citimes" citimes 
wig wig 
"-wig" — -wig 
"S>wig" >wig 
"<wig" <wig 


"=wig" =wig 
"star" star 
"pigstar" bigstar 
"=dot" =dot 


"orsign" orsign 
"andsign" andsign 


"=del" — =del 

"oppA" oppA 

"oppE" oppE 

"angstrom" 
FILES 

/ust/pub/eqnchar 
SEE ALSO 
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troff(1), eqn(1) 


" | | " | | 
"langle" langle 


"rangle" rangle 


"hbar" —s hbar 
"ppd" — ppd 
"<->" <-> 
"<=>" <=> 
ul eae |< 

wd ey |> 
"ang" ang 
"rang" rang 
"3dot" 3dot 
"thf" thf 


"quarter" quarter 
"3quarter" 3quarter 
angstrom "degree" 
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"square" square 
"circle" circle 


"blot" blot 
"bullet" bullet 
"prop" prop 


"empty" empty 
"member" member 
"nomem" nomem 


cup cup 
"cap" cap 
"incl" incl 


"subset" subset 
"supset" supset 
"Isubset" !subset 
"Isupset" !supset 
degree 
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NAME 


font — typesetter fonts 


DESCRIPTION 


The fonts named here may be available on some or all of the Autologic APS-5 phototypesetter, the Mergen- 
thaler Linotron 202 phototypesetter, the Canon laser printer, and the Teletype 5620 terminal running under 
mux(9.1). The names here are those appropriate to troff(1), and unless otherwise noted, refer to the 202. 
On the 5620 and the Canon there is a separate font for each style and size, denoted by the troff name fol- 
lowed by *.’ and a size, e.g. ‘CW.11’. Al Avant Garde A2 Avant Garde italic A3 Avant 
Garde bold A4 Avant Gard bold italic B Times bold B1 Bembo B2 Bembo italic 
B3 Bembo bold B4 Bembo bold italic BI Times bold italic C News Gothic con- 
densed (aps-5) CA Caslon CE Century Expanded (aps-5) CH Chess CI Century bold 
italic (aps-5) CS Constant Width Slanted CT Courier Typewriter (aps-5) CW Constant width 


(ASCII typewriter) CX News Gothic condensed italic (aps-5) E Eurostyle EB Eurostyle 
bold EK Eurostyle black EX Eurostyle bold extended FS Fraktur and Script GB Greek 
bold (aps-5) GR Greek GS German Script (aps-5) H Helvetica HB Helvetica bold 
HC Helvetica condensed HD Helvetica bold condensed HI Helvetica italic 
HJ Helvetica light italic HK Helvetica black HL Helvetica light HO Helvetica outline 
HX Helvetica bold italic I Times italic K Baskerville KB Baskerville bold 


KI Baskerville italic KK Korrina heavy black KX Baskerville bold italic M1 Universal 
[sic] Math 1 M2 Universal Math 2 M3 Universal Math 3 MB Memphis bold 
MI Memphis italic MK Memphis black MM Memphis medium MX Memphis bold italic 
MZ Memphis extra bold italic O Caslon old Ol Optima O2 Optima _ italic 
03 Optima bold O4 Optima bold italic O5 Optima black OE Old English 
Ol Caslon old italic OK Helvetic outline black PA Palatino PB Palatino bold 


PI Palatino italic PO Printout (ASCII constant width) PX Palatino bold _ italic 
R Times Roman S Special (math symbols) S1 Special (aps-5) SB Souvenir bold 
SC Script (aps-5) SI Souvenir italic SK Souvenir black SM Stymie medium (aps-5) 


SV Souvenir SX Souvenir bold italic SZ Souvenir black italic TB Techno bold (aps-5) 
TX Techno bold italic (aps-5) US United States (202) X1 Universal Newspaper Pi (202) 


apl bigblit Large mux font chess Chess pieces for mux defont Default mux font st texture 
tiny Minimum size mux font 


SEE ALSO 


Page | 


troff(1), can(1), jf(9), font(9) 
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NAME 
library, bellcat — bell labs library services 


SYNOPSIS 
library 


bellcat 


DESCRIPTION 
Library places orders with the Bell Labs library network for books, technical reports, etc. Its use is self- 
explanatory. 


Bellcat places a call to the Bell Labs on-line book catalog. Its use, too, is self-explanatory, except you must 
use *.’ to exit. 


BUGS 
Bellcat requires an HP2621 terminal, real or simulated, and produces some irrelevant chatter. 
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NAME 


mail — address conventions and rewrite rules 


DESCRIPTION 


Mail(1) accepts and converts among the addressing conventions of several computer networks, according 
to rules given in the file /usr/lib/upas/rewrite. Each line of the file is a rule. Blank lines and lines beginning 
with #° are ignored. 


Each rewriting rule consists of (up to) 6 strings: 


pattern An ed(1)-like regular expression, with simple parentheses () playing the role of \(\) and with the + 
and ? operators of egrep(1). The pattern is applied to mail addresses. 


command 
An ed(1) style replacement string to generate a command to deliver messages to the destination 
matched by the pattern. The substring ‘\s’, is replaced by the login id of the sender. The default is 
no command. 


next hop 
An ed(1) style replacement string that represents the name of next routing hop. The default is the 
empty string. See the section below on forwarding. 


next address 
An ed(1) style replacement string that represents the address as it will be seen at the next hop. The 
default is the empty string. See the section below on forwarding. 


conversion 
The name of the conversion that must be performed before the message is piped to the command. 
If this field is empty, no conversion is performed. The only conversion now known is rfc822, 
which makes the message conform to the ARPA RFC 822 mailer standard. 


system The name to use for the current system. The default name is found in /etc/vhoami. 


Each field, except for pattern, is optional if it and all fields following it are to assume the default values. 
Any empty field (e.g. ‘*’’) assumes the default value. 


When delivering a message, mail starts with the first rule and continues down the list until a pattern 
matches the destination address. If the rule contains no command, the mail is appended to the user’s mail- 
box in the standard way (see mail(1)). If the rule does contain a command, upas(8) starts the command and 
pipes the message to it, performing any requested conversion. 


Forwarding is controlled using the next hop and next address fields and the forwarding files. Using these 
fields, the rewriting rules are recursively applied to the source and destination addresses. If all hops in 
either source or destination are in the forwarding files, forwarding is allowed. If the forwarding files do not 
exist, blanket forwarding is assumed. 


EXAMPLES 
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Rewriting rules for major networks are: 


“PUD! YAS \L\ 
"uux 2>>/tmp/uuxl — —a \s \1 !rmail \\(\2\\)" 
“PYDIGFDICY+)IPI+)$ \4 "uux — —a \s \1 Irmail \\(\2\\)" 


network: ARPANET (arpa!person@ machine) 

“arpa!(.+)$ csnet "cs-inject \I.csnet-relay" rfc822 
network: CSNET (csnet!person @ machine) 

“csnet!(.+)$ csnet "cs-inject \l.csnet-relay" rfc822 


network: CSNET or ARPANET (person @machine) 


MAIL(7) Eighth Edition MAIL(7) 


*+[@ %.][°@%.]+$ csnet "cs-inject &.csnet-relay" rfc822 
network: ACSNET (acsnet!person @ machine.acsnet) 

“acsnet!(.+)$ ACSnet "acs-inject \1" rfc822 
network: BITNET (bitnet!person@machine) 


“pitnet!(.+)[.@](.+)$ csnet 
"cs-inject \1%\2.bitnet@ wiscvm.arpa.csnet-relay" rfc822 


The address on incoming mail depends largely on the originating mail program. However, the following 
can usually be relied upon to reach CS researchers at Bell Labs. 


UUCP: research!person 

CSNET: person @btl or person.machine @btl 
ARPANET: person @btl.csnet or person.btl@csnet-relay 
ACSNET: person @research or research!person 


BITNET: person%btl.csnet @wiscvm 


FILES 
/usr/lib/upas/rewrite the rewriting rules 


SEE ALSO 
uucp(1), mail(1), upas(8) 
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NAME 
man — macros to typeset manual 


SYNOPSIS 
nroff —man file ... 


troff -man file ... 


DESCRIPTION 
These macros are used to lay out pages of this manual. A skeleton page may be found in the file 
/usr/man/man0/xx. 


Any text argument ¢ may be zero to six words. Quotes may be used to include blanks in a ‘word’. If text is 
empty, the special treatment is applied to the next input line with text to be printed. In this way .I may be 
used to italicize a whole line, or .SM followed by .B to make small bold letters. 


A prevailing indent distance is remembered between successive indented paragraphs, and is reset to default 
value upon reaching a non-indented paragraph. Default units for indents i are ens. 


Type font and size are reset to default values before each paragraph, and after processing font and size set- 
ting macros. 


These strings are predefined by —-man: 
\*R “nh nroff. 
\*S Change to default type size. 


FILES 

/usr/lib/tmac/tmac.an 

/usr/man/man0/xx 
SEE ALSO 

troff(1), man(1) 
REQUESTS 
Request Cause If no Explanation 

Break Argument 

Bt no f=n.tl.* Text tis bold. 
.BIt no f=n.t.l. Join words of t alternating bold and italic. 


-BRt no f=n.t.. Join words of t alternating bold and Roman. 

.DT no .5i Li... Restore default tabs. 

-HP i yes i=p.i.* Set prevailing indent to i. Begin paragraph with hanging indent. 
It no f=ntJl. Text ris italic. 


Bt no f=n.t.l. Join words of t alternating italic and bold. 

IPxi yes) x="" Same as .TP with tag x. 

AR t no f=n.t... Join words of ¢ alternating italic and Roman. 

.LP yes - Same as .PP. 

PDd no d=4v Interparagraph distance is d. 

.PP yes - Begin paragraph. Set prevailing indent to .5i. 

-RE yes - End of relative indent. Set prevailing indent to amount of starting .RS. 

-RB t no f=n.t.. Join words of t alternating Roman and bold. 

-RIt¢ no f=n.t.l. Join words of t alternating Roman and italic. 

“RS i yes i=p.i. Start relative indent, move left margin in distance i. Set prevailing indent to .5i for nested 
indents. 


SH t yes f=n.t.l. Subhead. 
SM t no t=n.t.l. Text f is small. 


THncxyes - Begin page named n of chapter c; x is extra commentary, e.g. ‘local’, for page foot. Set 
prevailing indent and tabs to .51. 
.TP i yes i=p.i. Set prevailing indent to i. Begin indented paragraph with hanging tag given by next text 


line. If tag doesn’t fit, place it on separate line. 
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MAN(7) 
.XE no Use eqn(1) preprocessor; should be first in file. 
LC yes Equalize columns and return to 1-column output 
.2C yes Start 2-column nofill output 


* ntl. = next text line; p.i. = prevailing indent 


BUGS 
There is no direct way to suppress column widows in 2-column output; the column lengths may be adjusted 


by inserting .sp requests before the .1C 
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NAME 

map — draw maps on various projections 
SYNOPSIS 

map projection [ param ... ] [ option ... ] 
DESCRIPTION 


Map prepares on the standard output a map suitable for display by any plotting filter described in plot(1). 
A menu of projections is produced in response to an unknown projection. For the meanings of params per- 
tinent to particular projections see map (3). 


The default data for map are world shorelines. Option -f accesses more detailed data classified by feature. 


-f [ feature |... 
Known features are ranked 1 to 4 from major to minor, with a higher-numbered rank including all 
lower-numbered ones. A missing rank is taken to be 1. Features are 
shore[1-4] seacoasts, lakes, and islands; option -f always shows shore 1 
ilake[1-2] intermittent lakes 
river[1-4] rivers 
iriver[1-3] intermittent rivers 
canal[1-3] (canal3 = irrigation canals) 
glacier 
iceshelf[12] 
reef 
saltpan[12] 
country[123] (country[23] = disputed and indefinite boundaries) 
state states and provinces (US and Canada only) 


In the following list of other options all coordinates are in degrees, with north latitude and west longitude 
counted as positive. 


4ISNEW 
the southern and northern latitude and the eastern and western longitude limits of the desired map. 
Missing arguments are filled out from the list -90, 90, —180, 180, or lesser limits suitable to the 
projection in question. 


-0 lat lon rot 

Orient the map in a nonstandard position. Imagine a transparent gridded sphere around the globe. 
First turn the overlay about the North Pole so that the Prime Meridian (longitude 0) of the overlay 
coincides with meridian Jon on the globe. Then tilt the North Pole of the overlay along its Prime 
Meridian to latitude Jat on the globe. Finally again turn the overlay about its ‘North Pole’ so that 
its Prime Meridian coincides with the previous position of meridian rot. Project the desired map 
in the standard form appropriate to the overlay, but presenting information from the underlying 
globe. Missing arguments are filled out from the list 90, 0, 0. Default orientation is 90, 0, m, 
where m is the middle of the longitude range. 


—-wSNEW 
Window the map by the specified latitudes and longitudes in the tilted, rotated coordinate system. 
(It is wise to give an encompassing -l option with -w. Otherwise for small windows computing 
time varies inversely with area!) 


-dn Alter the density of points by plotting only every nth one. 


-r Reverse left and right side of map, for star charts and inside-out views. 
-s Save the screen, don’t erase before drawing. 
-g dlat dlon res 


Grid spacings are dlat, dlon (10 degrees by default). Zero spacing means no grid. Missing dlat is 
taken to be zero. Missing dlon is taken the same as dlat. Grid lines are drawn to a resolution of 
res (2 degrees by default). 
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—p lat lon extent 


Position the point Jat, lon at the center of the plotting area, and scale so that the height (and width) 
of the nominal plotting area is extent times the size of one degree of latitude at the center. For 
example, a standard schoolroom-wall Mercator map comes out as if positioned and scaled with —p 
0 0 360. 


-cxy After all other positioning and scaling operations have been performed, move the center of the 
map to position x, y, where the nominal plotting area is -I<x<1, -l<y<1. 

-m [ file ] ... 
Use map data from named files instead of the defaults. If no files are named, plot grid only. 
Names not the pathname of real files are looked up in a standard directory, which contains, in 
addition to the data for -f, 
world World Data Bank I from CIA (the default map) 
states US map from Census Bureau 
counties US map from Census Bureau 

-b Suppress border around map. 

-t[ file]... 
The following arguments name ASCII files that contain lists of points, given as latitude-longitude 
pairs in degrees. If the first file is named ‘—’, the standard input is taken instead. The points of 
each list are plotted as connected ‘tracks’, i.e. dot-dashed lines superimposed on the map. A non- 
numeric field optionally preceded by ‘"’ ends a track. The field together with everything up to the 
next newline is placed as a label at the last point of the track, positioned so that a leading character 
such as ‘+’ or ‘X’ will fall on the point. 

-u [ file]... 


Same as —t, except the tracks are unbroken lines. 


The environment variables MAP and MAPDIR change the default map and default directory. 


EXAMPLES 


A ‘polar’ map centered on New York (actually a low-orbit view): map perspective 1.025 —o 40.75 74. The 
job can be done faster by limiting the map so as not to ‘plot’ the invisible part of the world: map perspec- 
tive 1.025 -o 40.75 74 -1 20 60 30 100. 

An ‘equatorial’ map of the earth centered on New York: map mercator —o 49.25 —106 180. The pole of the 
map is placed 90 degrees away on the other side of the earth. A 180-degree twist around the pole of the 
map arranges that the ‘Prime Meridian’ of the map runs from the pole of the map over the North Pole to 
New York instead of down the back side of the earth. The same effect can be had from: map mercator —o 
130.75 74. 

A customary curved-latitude map of the United States: map albers 28 45 —1 20 50 60 130. 


/n/bowell/usr1/maps default directory, contains following files 


«403 World Data Bank II 


World Data Bank I 


map(5), map(3), plot(1) 


‘map seems to be empty’—the intersection of the limits and the window seems to be null; for very local 
maps, the grid resolution res may have to be refined. 


FILES 
101,102, 
world 
states 
counties 
SEE ALSO 
DIAGNOSTICS 
BUGS 


Border lines appear only along boundaries that arise from —] and —w options. 
Segments that cross a map border are dropped. 
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mcs — macros for formatting cover sheets 


SYNOPSIS 
troff —mces file ... 


DESCRIPTION 


The —mcs macro package defines macros for use with troff to generate a document cover sheet. These mac- 


ros need the —ms macros. 


Following is a summary of the —mcs macros and argument list with a brief description of each macro; 
explanations are provided as needed. Macros marked with * are mandatory; all other macros are optional. 
Optional arguments are enclosed in square brackets. The macros must be used in the order presented: 


Request Explanation 

* TI Title text follows 

* .AH name loc dept ext rm Author 

* SA Begin Abstract 

* SE End Abstract 
.KW [k1] ... [k9] Keywords 


* .MT type software 


Memo Type (TM, IM, TC), software related (“‘y’) (Technical Memorandum, 
Internal Memorandum, Technical Correspondence) 


* .NU org-date-seq filing case work project 


Document Number, default work project is that of 1127 


MY [y] Ly] Ly] Ly] Ly] Ly] Ly] 


.PR [BR] 
.GS 
* .CI code 


CO [y] 

.CE 

CV [y] 

SC pgs oth fig tab ref 


* 


FILES 
/usr/lib/tmac/tmac.cs 
/usr/lib/tmac/tmac.rscover 


SEE ALSO 


Mercury Code, positional arguments, max=3 | = Chemistry & Materials, 2 = 
Communications, 3 = Computing, 4 = Electronics, 5 = Life Sciences, 6 = Math 
& Statistics, 7 = Physics 

Proprietary Marking — default ATT-BL Proprietary, BR=restricted 
Government Security 

CI-II Review ‘y’ = CONTAINS CI-II info; MAY NOT be distributed to 
AT&T-IS ‘n’ = DOES NOT CONTAIN CI-II info; MAY be distributed to 
AT&T-IS 

Complete Copy Distribution List follows, ‘y’ = 1127 default 

End distribution lists 

Cover Sheet Only Distribution List follows, ‘y’ = 1127 default 

Cover Sheet 


docgen(1), ms(7), sendcover(1) 


BUGS 


Footnotes in abstracts do not work. 
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MS(7) Eighth Edition MS(7) 


NAME 
ms — macros for formatting manuscripts 


SYNOPSIS 
nroff —ms [ options ] file ... 
troff-—ms [ options ] file ... 


DESCRIPTION 
This package of nroff and troff macro definitions provides a canned formatting facility for technical papers 
in various formats. When producing 2-column output on a terminal, filter the output through co/(1). 


The macro requests are defined below. Many nroff and troff requests are unsafe in conjunction with this 
package, but these requests may be used with impunity after the first .PP: 


.bp begin new page 

-br_ break output line here 

.Sp n insert n spacing lines 

ls n (line spacing) n=1 single, n=2 double space 
.na_ no alignment of right margin 


Output of the egn, neqn, tbl, and refer(1) preprocessors for equations, tables and references is acceptable as 
input. 


Diacritical marks may be applied to letters, as in these examples: 


\*e \**a \*’e \*%e \**o \e:u en \*,c \*vc 
é a é é 6 i fi ¢ c 
FILES 
/usr/lib/tmac/tmac.s 
SEE ALSO 
eqn(1), troff(1), refer(1), tbl1(1) 
REQUESTS 
Request Initial Cause Explanation 
Value Break 
LC yes yes One column format on a new page. 
2C no yes Twocolumn format. 
.AB no yes _ Begin abstract. 
AE - yes End abstract. 
AI no yes  Author’s institution follows. Suppressed in TM. 


AT no yes __ Print ‘Attached’ and turn off line filling. 
-AUxy no yes  Author’s name follows. x is location and y is extension, ignored except in TM. 
Bxy no no _ Print xin boldface and append y; if no argument switch to boldface. 


.B1 no yes Begin text to be enclosed in a box. 

.B2 no yes End boxed text. 

.BT date no Bottom title, automatically invoked at foot of page. May be redefined. 

BX x no no _ Print x ina box. 

CS x. - yes Cover sheet info if TM format, suppressed otherwise. Arguments are number of text pages, 
other pages, total pages, figures, tables, references. 

.CT no yes __ Print ‘Copies to’ and turn off line filling. 

.DA x nroff no ‘Date line’ at bottom of page is x. Default is today. 

.DE - yes End displayed text. Implies .KE. 


.DS x no yes Start of displayed text, to appear verbatim line-by-line. x=I for indented display (default), 
x=L for left-justified on the page, x=C for centered, x=B (block) for centered with straight 
left margin. Implies .KS. 

.EG no - Print document in BTL format for ‘Engineer’s Notes.’ Must be first. 

.EN - yes Space after equation produced by eqn or neqn. 
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MS(7) Eighth Edition MS(7) 


LEQxy - yes Display equation. Equation number is y. Optional argument x=I, L, C as in .DS. 

.FE - yes End footnote. 

.FP - no Set font positions for a family, e.g., ".FP palatino" 

FS no no __ Start footnote. The note will be moved to the bottom of the page. 

.HO - no ‘Bell Laboratories, Holmdel, New Jersey 07733’. 

Ixy no no __Italicize x and append y; if no argument switch to Italic. 

JH no no ‘Bell Laboratories, Naperville, Illinois 60540’ 

.IM no no __ Print document in BTL format for an internal memorandum. Must be first. 

.JPxy no yes _ Start indented paragraph, with hanging tag x. Indentation is y ens (default 5). 

.KE - yes End keep. Put kept text on next page if not enough room. 

.KF no yes _ Start floating keep. If the kept text must be moved to the next page, float later text back to 
this page. 

.KS no yes _ Start keeping following text. 

.LG no no Make letters larger. 

.LP yes yes Start left-blocked paragraph. 

.LT no yes _ Start a letter with today’s date; address follows. 

.MF - - Print document in BTL format for “Memorandum for File.’ Must be first. 

.MH - no ‘Bell Laboratories, Murray Hill, New Jersey 07974’. 

.MR - - Print document in BTL format for ‘Memorandum for Record.’ Must be first. 

.ND date troff no Use date supplied (if any) only in special BTL format positions; omit from page footer. 

.NH n - yes Same as .SH, with section number supplied automatically. Numbers are multilevel, like 
1.2.3, where n tells what level is wanted (default is 1). 

.NL yes no Make letters normal size. 

.OK - yes ‘Other keywords’ for TM cover sheet follow. 

.PP no yes Begin paragraph. First line indented. 

.PT pg# - Page title, automatically invoked at top of page. May be redefined. 

.PY - no ‘Bell Laboratories, Piscataway, New Jersey 08854’ 

.QE - yes End quoted material. 

.QP - yes Begin single quoted paragraph (indent both margins). 

.QS - yes Begin quoted material (indent both margins). 

.R yes no Roman text follows. 

.RE - yes End relative indent level. 

-RP no - Cover sheet and first page for released paper. Must precede other requests. 

-RS - yes Start level of relative indentation from which subsequent indentation is measured. 

SG x no yes Insert signature(s) of author(s), ignored except in TM. x is the reference line (initials of 
author and typist). 

.SH - yes Section head follows, font automatically bold. 

SM no no Make letters smaller. 

.TAx.. 5... no  Settabsinens. Default is5 1015... 

.TE - yes End table. 

.TH - yes End heading section of table. 

.TL no yes _ Title follows. 

.TMx... no - Print document in BTL technical memorandum format. Arguments are TM number, (quoted 
list of) case number(s), and file number. Must precede other requests. 

.TRxX - - Print in BTL technical report format; report number is x. Must be first. 

.TS x - yes Begin table; if x is H table heading is repeated on new pages. 

.UL x - no Underline argument (even in troff). 

.UX - no ‘UNIX’; first time used, add footnote ‘UNIX is a trademark of Bell Laboratories.’ 

.WH - no ‘Bell Laboratories, Whippany, New Jersey 07981’. 

.L - no Begin reference; see refer(1) 

J - no Endreference 
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SKY(7) 


NAME 


Eighth Edition (grigg) SKY(7) 


sky — calculate ephemerides 


SYNOPSIS 


sky [41] 


DESCRIPTION 


FILES 


Sky predicts the apparent locations of the Sun, the Moon, the planets out to Saturn, stars of magnitude at 
least 2.5, and certain other celestial objects. Sky reads the standard input to obtain a GMT time typed on 
one line with blanks separating year, month number, day, hour, and minute; if the year is missing the cur- 
rent year is used. If a blank line is typed the current time is used. The program prints the azimuth, eleva- 
tion, and magnitude of objects which are above the horizon at the ephemeris location of Murray Hill at the 
indicated time. The ‘-l’ flag causes it to ask for another location. 


Placing a ‘1’ input after the minute entry causes the program to print out the Greenwich Sidereal Time at 
the indicated moment and to print for each body its topographic right ascension and declination as well as 
its azimuth and elevation. Also, instead of the magnitude, the semidiameter of the body, in seconds of arc, 
is reported. 


A ‘2’ after the minute entry makes the coordinate system geocentric. 


The effects of atmospheric extinction on magnitudes are not included; the brightest magnitudes of variable 
stars are marked with ‘*’. 


For all bodies, the program takes into account precession and nutation of the equinox, annual (but not diur- 
nal) aberration, diurnal parallax, and the proper motion of stars. In no case is refraction included. 


The program takes into account perturbations of the Earth due to the Moon, Venus, Mars, and Jupiter. The 
expected accuracies are: for the Sun and other stellar bodies a few tenths of seconds of arc; for the Moon 
(on which particular care is lavished) likewise a few tenths of seconds. For the Sun, Moon and stars the 
accuracy is sufficient to predict the circumstances of eclipses and occultations to within a few seconds of 
time. The planets may be off by several minutes of arc. 


There are lots of special options not described here, which do things like substituting named star catalogs, 
smoothing nutation and aberration to aid generation of mean places of stars, and making conventional 
adjustments to the Moon to improve eclipse predictions. 


For the most accurate use of the program it is necessary to know that it actually runs in Ephemeris time. 


/usr/lib/startab, /usr/lib/moontab 


SEE ALSO 
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American Ephemeris and Nautical Almanac, for the appropriate years; also, the Explanatory Supplement to 
the American Ephemeris and Nautical Almanac. 


TEL (7) Eighth Edition TEL(7) 


NAME 
tel — local and private telephone books 


SYNOPSIS 
tel name 


DESCRIPTION 
Tel looks up name in a private telephone book, ‘$HOME/lib/tel’, if it exists, and in a local book ‘/lib/tel.’ 


Tel is simply a script for grep(1), so lookup may be by any part of the name or number. Customarily the 
local telephone book contains names, userids, home numbers, and office numbers of users. It also contains 
a directory of area codes and miscellaneous people of some general interest. 


SEE ALSO 
telno(7) 
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TELNO (7) Eighth Edition TELNO(7) 


NAME 
telno — retrieve from Bell Labs phone book 


SYNOPSIS 
telno [ datum ... datum ] 


DESCRIPTION 
If there are no arguments on the command line, telno reads its arguments, one to a line, from the standard 
input. Arguments are names, phone numbers, or organization numbers, possibly preceded by a keyword 
and an equal sign. The first character of a name must be a letter, of a phone number or organization number 
a digit. Otherwise regular expressions a la grep(1) are accepted. Names are prefixes of last names, or the 
last name followed by a comma and one initial. 


Giving a name, a phone number, or an organization number (org=127) produces white pages information. 
SEE ALSO 
tel(7) 


DIAGNOSTICS 
too long means that the given name has more letters than any name in the phone book. (AII the names are 
truncated to 8 characters before the data arrives on the machine.) None is printed when there are no 
matches. 


BUGS 
The phone book is badly out of date. 
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NAME 


terminals — conventional names 


DESCRIPTION 


These names are used by certain commands and are maintained as part of the shell environment (see 
sh(1),environ(5)). 


adm3a Lear Seigler Adm-3a 
2621 Hewlett-Packard HP262? series terminals 
1620 DIABLO 1620 (and others using HyType II) 


300 DASI/DTC/GSI 300 (and others using HyType I) 
33 Teletype Model 33 

37 Teletype Model 37 

43 Teletype Model 43 

5620 Teletype Model 5620 dotmap display 

735 Texas Instruments TI735 (and TI725) 

745 Texas Instruments T1745 

dumb terminals with no special features 

4014 Tektronix 4014 

vt52 Digital Equipment Corp. VT52 


The list goes on and on. Consult /etc/termcap (see termcap(5)) for an up-to-date and locally correct list. 


Commands whose behavior may depend on the terminal either consult TERM in the environment, or accept 
arguments of the form —Tterm, where term is one of the names given above. 


SEE ALSO 


BUGS 
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stty(1), tabs(1), plot(1), sh(1), environ(5) clear(1), underline(1), stty(1), tset(1), termcap(5) 
troff(1) for nroff 


The programs that ought to adhere to this nomenclature do so only fitfully. 


TOWN(7) Eighth Edition (alice) TOWN(7) 


NAME 
town /- gazetteer of US places 

SYNOPSIS 
town [ place ] 

DESCRIPTION 
Town produces information about the place, which is the name of a US town, possibly followed by a 
comma and a two-letter state abbreviation. If no place is given, place names are read one per line from the 
standard input. 
The information produced is latitude, longitude, approximate population, a forecast from weather(7), and a 
recent item from apnews(1). 

FILES 
/usr/spool/town/ustown* gazetteer in cbt(1) format 

SEE ALSO 


apnews(1), weather(1) 
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TROFF (7) Eighth Edition TROFF(7) 


NAME 
troff — addenda to troff manual 


DESCRIPTION 
These addenda apply to the reference. 


New requests; none cause breaks: 


.ab t print text ¢ on standard error and stop 

ch f copy file finto troff output uninterpreted; assume net motion is 0 
Sy C execute unix comand c 

pic pipe output of troff through command c 


Deleted request: 
li 
New escape sequences 


\D11 dh dv’ 
draw line dh horizontally and dv vertically 
\D’cd’ draw circle with diameter d extending right from current position 
\D’e hv’ draw ellipse with axis 
h extending right from current position and vertical axis v 
\D’a dhI dv1 dh2 dv2° 
arc counterclockwise from here, centered at dh1,dv1 to dhIl+dh2,dv1+dv2 
\D*~ dhl dv1 dh2 dv2 ...” quadratic spline 
\gr or \g(vr 
format of number register r or rr; empty if not defined 
\H’n’ character height of present font is n points, width unchanged; n=0 for present point size; +n incre- 
ments; —n decrements 
\S‘n’ slant output n degrees; n may be negative 


New number registers: 


$$ process id of troff; read only 

line spacing (.ls); read only 

1 if page is being printed; 0 if suppressed by -o; read only 

number of unused number registers 

emboldening factor (.bd) 

.ad setting, usable as argument to .ad 

horizontal size of text (excluding indent) of current partial output line 
Cc. input line-number, counting from | in each file; same as .c, but writable 
.T troff output device name (a string: \*(.T) 


Roo 


Number register deleted: 
hp 


SEE ALSO 
J. F. Ossanna, NROFF/TROFF Reference Manual 
troff(1) 


Page | 


UNITS(7) Eighth Edition UNITS(7) 


NAME 


units — conversion program 


SYNOPSIS 


units 


DESCRIPTION 


FILES 


BUGS 
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Units converts quantities expressed in various standard scales to their equivalents in other scales. It works 
interactively in this fashion: 


You have: inch 

You want: cm 
* 2.54000e +00 
/ 3.93701e-Ol 


A quantity is specified as a multiplicative combination of units optionally preceded by a numeric multiplier. 
Powers are indicated by suffixed positive integers, division by the usual sign: 


You have: 15 pounds force/in2 
You want: atm 

* 1.02069e+00 

/ 9.79730e-01 


Units only does multiplicative scale changes. Thus it can convert Kelvin to Rankine, but not Centigrade to 
Fahrenheit. Most familiar units, abbreviations, and metric prefixes are recognized, together with a generous 
leavening of exotica and a few constants of nature including: 


pi ratio of circumference to diameter 
c speed of light 

e charge on an electron 

g acceleration of gravity 


force sameasg 

mole Avogadro’s number 

water pressure head per unit height of water 
au astronomical unit 


‘Pound’ is a unit of mass. Compound names are run together, e.g. ‘lightyear’. British units that differ from 
their US counterparts are prefixed thus: ‘brgallon’. Currency is denoted “belgiumfranc’, ‘britainpound’, ... 
For a complete list of units, ‘cat /usr/lib/units’ . 


/ustr/lib/units 


Don’t base your financial plans on the currency conversions. 


WEATHER (7) Eighth Edition (alice) WEATHER(7) 


NAME 

weather — conditions and forecast by town 
SYNOPSIS 

weather [ —h ] [ —m ] 
DESCRIPTION 


Weather reports current weather conditions and a forecast for towns in the contiguous United States. It 
reads town names from the standard input, one per line. Each input line should be of the form 


walla walla, wa 
where the state is given as the 2-letter Post Office abbreviation. 


The information provided is the temperature, humidity, whether or not it is raining or snowing, and an indi- 
cation of cloudiness and visibility if it is not. If the wind is above 10 knots the wind speed and direction are 
given. Up to three forecasts are given (assuming they can be found within a 4x4 degree latitude-longitude 
square): a forecast of high and low temperatures plus probability of precipitation taken from some numeri- 
cal model of the atmosphere, a general area forecast and a marine forecast (if near the coast and if the -m 
argument is given). 


To just get a local forecast, the command weather —h is equivalent to weather followed by a single input 
line of Murray Hill, NJ. 


BUGS 
Not all the available information is used yet: we hope cumulative precipitation will be added, and additional 
forecasts will be included. 
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11(8) Eighth Edition 11(8) 


NAME 
1las, llcec, 111d, 11nm, 11ranlib, 11reloc, 11size, 11strip — pdp11 support 


DESCRIPTION 
These programs do cross-compiling and related support functions for the DEC PDP-11 family of comput- 


ers. Their descriptions correspond closely with those of similarly named programs in Section 1 of this 


manual. 


FILES 
lla.out output file 
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AC(8) Eighth Edition AC(8) 

NAME 
ac — login accounting 

SYNOPSIS 
/etc/ac [—w wtmp ] [-p ] [-d ] [ people ] ... 

DESCRIPTION 
Ac produces a printout giving connect time for each user who has logged in during the life of the current 
wtmp file. A total is also produced. —w is used to specify an alternate wtmp file. A value of ‘—’ specifies 
that wtmp records appear on the standard input. —-p prints individual totals; without this option, only totals 
are printed. —d causes a printout for each midnight to midnight period. Any people will limit the printout 
to only the specified login names. If no wtmp file is given, /usr/adm/wtmp is used. 
The accounting file /usr/adm/wtmp is maintained by init and login. Neither of these programs creates the 
file, so if it does not exist no connect-time accounting is done. To start accounting, it should be created 
with length 0. On the other hand if the file is left undisturbed it will grow without bound, so periodically 
any information desired should be collected and the file truncated. 

FILES 
/usr/adm/wtmp 

SEE ALSO 
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init(8), sa(8), login(8), utmp(5). 


ARFF(8 ) 


NAME 


Eighth Edition ARFF(8) 


arff — read RT11 files 


SYNOPSIS 
arff [ key ] [ name ... ] 


DESCRIPTION 
Arff saves and restores files from an RT11 volume, such as the VAX console floppy or tape. Its actions are 
controlled by the key argument. The key is a string of characters containing at most one function letter and 
possibly one or more function modifiers. Other arguments to the command are file names specifying which 
files are to be dumped or restored. 


RT11 filenames must be chosen from the character set a-z0-9.. Unix filenames are trimmed to the last path- 
name element; upper-case letters are folded to lower-case. 


The key must include one of the following letters: 


r 


The named files are replaced where found in the RT11 volume, or added taking up the minimal 
possible portion of the first empty spot. 


The named files are extracted from the RT11 volume. 


The named files are deleted from the volume. The resulting empty spots are coalesced where pos- 
sible. 


A table of contents for the RT11 volume is printed. If filenames are given, they are echoed if 
found. 


The following modifiers may be added to the key: 


v Normally arff does its work silently. The v (verbose) option causes it to type the name of each file 
it treats preceded by the function letter. With the t function, v gives more information about the 
file than just the name. 

f causes arff to use the next argument as the name of the archive instead of /dev/floppy. 

m causes arff not to use the mapping algorithm employed in interleaving sectors around a floppy 
disk. In conjunction with the f option it may be used for extracting files from non-floppy sources, 
such as the VAX-11/750 console cassette. 

FILES 

/dev/floppy 
AUTHORS 

Keith Sklower, Richard Tuck 
BUGS 
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Floppy errors are handled ungracefully. 
The program is too floppy-dependent. Mapping belongs in the device driver, or at least shouldn’t be the 


default. 


ASD(8) 


NAME 


Eighth Edition ASD(8) 


mkpkg, inspkg, seal, unseal — automatic software distribution 


SYNOPSIS 


mkpkg [ options ] files 

inspkg [ options ] files 

seal [ -k ] [-K keyfile ] [ file... ] 
unseal [ -k ] [ -K keyfile ] [ file... ] 


DESCRIPTION 


These commands are the basis of automatic software distribution as used in ship(1). 


Mkpkg collects files and directories into a ‘package’, which is written on the standard output. It reads the 
standard input for remarks to include in the package, and will prompt for these if the standard output is a 
terminal. 


Inspkg opens packages and installs their contents, printing the remarks included in the package. Since 
inspkg has no special privileges, installation should be done by the owner of the files being installed or by 
the super-user. 


The information contained in a package includes the full pathnames of the objects, links among the objects, 
their owners, groups, file modes, and modification dates. Owners and groups are stored as their character 
representations, to avoid problems if systems use different numeric codes for a single owner or group. 
Nonexistent objects are noted for deletion by inspkg. 


Options are: 

-v Verbose mode. 

—n If packaging, don’t ask for remarks. If installing, skip the actual installation, but do backup if 
requested. 

-b Backup mode, meaningful only with inspkg. Write on the standard output a package that contains 


everything that was destroyed during installation. 


—Dpathl=path2 
Pretend that a pathname beginning with path/ really begins with path2. 


A package is an archive (see ar(1)) with a component named ‘instructions’ that contains installation infor- 
mation. 


Seal produces on the standard output a file containing the same information as the concatenation of all its 
input files, in a form suitable for shipment by mail. If no input files are specified, seal reads its standard 
input. 


Unseal reads files produced by seal and produces the original file contents as its output. 


A sealed file includes a checksum; if the -k option is specified, seal prompts for a key to encrypt the data 
before calculating the checksum. 


If the -K option is specified, the program uses the first line of the given keyfile to supply the key. Subse- 
quent lines are ignored. 


SEE ALSO 


BUGS 
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ship(1) 


File names with embedded white space are mishandled. 


CHOWN (8 ) Eighth Edition CHOWN(8) 


NAME 
chown, chgrp — change owner or group 


SYNOPSIS 
/etc/chown owner file ... 


/etc/chown owner, group file ... 
/etc/chgrp group file ... 


DESCRIPTION 
Chown changes the owner of the files to owner and optionally changes the group-ID of the files to group. 


Chgrp changes the group-ID of the files to group. 


The owner may be either a decimal UID or a login name found in /etc/passwd. The group may be either a 
decimal GID or a group name found in /etc/group. 


Only the super-user can change owner or group. 


FILES 
/etc/passwd 
/etc/group 
SEE ALSO 


chown(2), passwd(5), group(5) 
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CLRI(8) Eighth Edition CLRI(8) 


NAME 
clri — clear i-node 


SYNOPSIS 
/ete/clri filesystem i-number ... 


DESCRIPTION 
Clri writes zeros on the i-nodes with the decimal i-numbers on the filesystem. After clri, any blocks in the 
affected file will show up as ‘missing’ in an icheck(8) of the filesystem. 


Read and write permission is required on the specified file system device. The i-node becomes allocatable. 


The primary purpose of this routine is to remove a file which for some reason appears in no directory. If it 
is used to clear an i-node which does appear in a directory, care should be taken to track down the entry and 
remove it. Otherwise, when the i-node is reallocated to some new file, the old entry will still point to that 
file. At that point removing the old entry will destroy the new file. The new entry will again point to an 
unallocated i-node, so the cycle is likely to be repeated. 


Clri is obsoleted for normal file system repair work by fsck(8). 


SEE ALSO 
fsck(8), icheck(8) 


BUGS 
If the file is open, c/ri is likely to be ineffective. 
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CONFIG (8 ) Eighth Edition CONFIG(8) 


NAME 
config — configure a Unix kernel 
SYNOPSIS 
/etc/config [| machine ] 
DESCRIPTION 
Config generates files used to build a Unix kernel for the named machine. The working directory should be 
/usr/sys/conf or /usr/sys/machine; if the latter, machine may be omitted from the command. 
A machine description is expected in machine/conf; a makefile, a number of header files, and some C and 
assembler programs are generated from the description. 
The usual way to configure a new system is: 
mkdir /usr/sys/newmach 
cd /usr/sys/newmach 
(create conf) 
/etc/config 
make 
FILES 
../conf/makefile makefile template 
../conf/files list of kernel source files 
files more sources specific to this machine 
../conf/devices list of device handlers 
devices more devices specific to this machine 
conf machine description 
SEE ALSO 
config(5) 
BUGS 


At the moment, it’s also necessary to create /usr/sys/machine/sparam.h. 
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CPP (8) Eighth Edition CPP(8) 


NAME 
cpp — C language preprocessor 


SYNOPSIS 
Nib/cpp [ option ... ] [ ifile [ ofile ] ] 


DESCRIPTION 
Cpp interprets control lines (marked with ‘#’) for cc(1) and other compilers. The input, jfile, and output, 
ofile, default to standard input and standard output respectively. 


The options are: 
-P Do not place ‘#line’ indications on the output. 
-C Do not remove comments. 


—Uname 

—Dname 

—Dname=def 

-Idir Sameas incc(1). —U overrides —D. 


—-M Pass modification date with file names, in the form file@modtime, where modtime is the integer 
number of seconds since the epoch. 


-T Truncate preprocessor symbols to eight characters. 


c) 


The name ‘__LINE__”’ is the current line number in the input file, ‘_ FILE ”’ is the file name. The line 


number and (optionally) the file name may be set by 
#line integer-constant 


These symbols are also predefined in various implementations: 
operating system: 
ibm, gcos, os, tss, unix 
hardware: interdata, pdp11, u370, u3b, u3b5, vax 
UNIX system: RES, RT 
lint(1): lint 


Any number of blanks and tabs are allowed between the initial ‘#’ and the control directive. 


A builtin function ‘defined(name)’ or ‘defined name’ may be used in constant expressions within a #if con- 
trol lines to test whether name is defined. 


Preprocessor formal parameters are recognized withing quoted strings in the replacement text. When com- 
ments are removed, they are replaced by null strings; this unofficial feature makes it possible to construct 
identifiers by concatenation. 


FILES 
/usr/include standard directory for include files 
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CRON (8 ) Eighth Edition CRON(8) 


NAME 
cron — clock daemon 


SYNOPSIS 
/etc/cron 


DESCRIPTION 
Cron executes commands at specified dates and times according to the instructions in the file /etc/crontab. 
Since cron never exits, it should be executed only once, by running cron from the initialization process 
through the file /etc/rc; see init(8). 


Crontab consists of lines of seven fields each. The fields are separated by spaces or tabs. The first field 
specifies the user under whose uid and gid the command should be executed. The next five are integer pat- 
terns to specify the minute (0-59), hour (0-23), day of the month (1-31), month of the year (1-12), and day 
of the week (1-7 with 1=Monday). Each of these patterns may contain a number in the range above; two 
numbers separated by a minus meaning a range inclusive; a list of numbers separated by commas meaning 
any of the numbers; or an asterisk meaning all legal values. The seventh field is a string that is executed by 
the shell at the specified times. A percent character in this field is translated to a new-line character. Only 
the first line (up to a % or end of line) of the command field is executed by the Shell. The other lines are 
made available to the command as standard input. 


Crontab is examined by cron every minute. 


FILES 
/etc/crontab 
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DMESG (8) Eighth Edition DMESG(8) 


NAME 


dmesg — system diagnostic messages 


SYNOPSIS 


/etc/dmesg [ — ] [ -i ] [ core namelist ] 


DESCRIPTION 


FILES 


BUGS 
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Dmesg looks in a system buffer for recent kernel diagnostic messages and reproduces them on the standard 
output. If the — flag is given, dmesg produces only those messages printed by the system since the last time 
‘dmesg — was run. This can be used with cron(8) to produce the error log /usr/adm/messages by running 
the command 


/etc/dmesg — >> /usr/adm/messages 
periodically. 


If -i is given, messages produced since the last dmesg — are printed; the memory of which messages have 
been recorded is not changed. 


If core and namelist are specified, they are used in place of /dev/kmem and /unix. 


/usr/adm/messages error log 
/usr/adm/msgbuf scratch file for memory of — option 


Since the system error message buffer is of small finite size, not all error messages are guaranteed to be 
logged. 


Error diagnostics generated immediately before a system crash cannot be logged. 


FINDDEV (8) Eighth Edition FINDDEV(8) 


NAME 

finddev — find processes using a device 
SYNOPSIS 

/etc/finddev [ pid ] ... [ file ] ... 
DESCRIPTION 


When invoked without arguments, finddev prints the number of every process and a description of each file 
referred to by that process. Giving one or more process numbers restricts finddev’s attention to those pro- 
cesses. 


If file arguments appear, finddev prints only the process numbers of those processes that refer to files in the 
argument list. If an argument file is an ordinary file, character special file, or directory, the process must 
refer to that file to be counted. If an argument is a block special file containing a mounted file system, a 
process will be counted if it refers to any file on that file system. 


To see details of all processes referring to, say, the console, try: 
finddev *finddev /dev/console’ 


Finddev has no special privileges. To use it, the user must have permission to read /dev/mem. 
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FSCK(8) Eighth Edition FSCK(8) 


NAME 


fsck — file system consistency check and interactive repair 


SYNOPSIS 


/etc/fsck —p [ filesystem ... ] 
/ete/fsck [ -y ] [-n ] [-sX ] [-SX ] [-+ filename ] [ filesystem ] ... 


DESCRIPTION 


Page | 


The first form of fsck preens a standard set of filesystems (those mentioned in /etc/fstab) or the specified file 
systems. It is normally called from /etc/rc during automatic reboot. 


The file /etc/fstab defines the order in which disks are checked by assigning each file system to a “‘pass’’ of 
fsck. Normally, the root file system will be checked on pass 1, and other files on later passes. For 
savecore(8) to work, no more than three large file systems should be checked on each pass. A file system is 
not checked if its pass number is 0 or it is not to be mounted. 


Fsck with the —p option will repair only the following ailments: 
unreferenced i-nodes; 
wrong link counts in i-nodes; 
missing blocks in the free list; 
blocks in the free list also in files; and 
counts wrong in the super-block. 


If fsck encounters other inconsistencies, it exits with an abnormal return status and the automatic reboot 
aborts. For each corrected inconsistency one or more lines will be printed identifying the file system and 
the nature of the correction. After successfully preening a file system, fsck will print the number of files on 
that file system and the number of used and free blocks. 


Without the —p option, fsck audits and interactively repairs inconsistent conditions on file systems. If the 
file system is inconsistent the operator is prompted for concurrence before each correction is attempted. 
The operator may require arcane knowledge to guide fsck safely through repair of a badly damaged file sys- 
tem. 


The following flags are interpreted by fsck. 
-y Assume a yes response to all questions asked by fsck; this should be used with great caution. 


—n Assume a no response to all questions asked by fsck; do not open the file system for writing. This 
option is enabled automatically if the file system is not writable. 


-sX Ignore the actual free list and (unconditionally) reconstruct a new one by rewriting the super-block 
of the file system. The file system should be unmounted while this is done; if this is not possible, 
care should be taken that the system is quiescent and that it is rebooted immediately afterwards. 
This precaution is necessary so that the old, bad, in-core copy of the superblock will not continue to 
be used, or written on the file system. If the file system has a bitmap free list (see filsys(5)), the free 
list is always reconstructed unless the —n option is enabled. 


The -sX option allows for creating an optimal free-list organization. The following forms of X are 
supported for the following devices: 


—s3 (RPO3) 
-s4 (RP04, RPO5, RP06) 
-sBlocks-per-cylinder:Blocks-to-skip (for anything else) 


If X is not given, the values used when the filesystem was created are used. If these values were not 
specified, then the value 400-9 is used. 


-SX Conditionally reconstruct the free list. This option is like -sX above except that the free list is rebuilt 
only if there were no discrepancies discovered in the file system. The -S option enables —n. 


FSCK(8) Eighth Edition FSCK(8) 


-t If fsck cannot obtain enough memory to keep its tables, it uses a scratch file. If the -t option is 
specified, the file named in the next argument is used as the scratch file, if needed. Without the -t 
flag, fsck will prompt the operator for the name of the scratch file. The file chosen should not be on 
the filesystem being checked, and if it is not a special file or did not already exist, it is removed 
when fsck completes. 


If no filesystems are given to fsck then a default list of file systems is read from the file /etc/fstab. 
Inconsistencies checked are as follows: 


Blocks claimed by more than one inode or the free list. 
Blocks claimed by an inode or the free list outside the range of the file system. 
Incorrect link counts. 
Size checks: 
Directory size not 16-byte aligned. 
Bad inode format. 
Blocks not accounted for anywhere. 
Directory checks: 
File pointing to unallocated inode. 
Inode number out of range. 
Super Block checks: 
More than 65536 inodes. 
More blocks for inodes than there are in the file system. 
Bad free block list format. 
Total free block and/or free inode count incorrect. 


Orphaned files and directories (allocated but unreferenced) are reconnected by placing them in the 
lost+found directory. The name assigned is the inode number. The only restriction is that the directory 
lost+found must exist in the root of the filesystem being checked and must have empty slots in which 
entries can be made. 


Checking the raw device is almost always faster for 1K-block file systems, but bitmap file systems must be 
checked using the block device. 


FILES 

/etc/fstab contains default list of file systems to check. 
SEE ALSO 

fstab(5), filsys(5), crash(8), reboot(8) 
BUGS 


Inode numbers for. and .. in each directory should be checked for validity. 


The ‘three large filesystems’ rule assumes a system with 4 megabytes of memory and a 20 megabyte swap 
area. Your mileage may vary. The goal is to avoid overwriting the part of the swap area where the dump 
lives. 
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GETTY (8) Eighth Edition GETTY (8) 


NAME 


getty — set terminal mode 


SYNOPSIS 


/etc/getty [ char ] 


DESCRIPTION 


Getty is invoked by init(8) immediately after a terminal is opened, following the making of a connection. 
While reading the user’s name getty attempts to adapt the system to the speed and type of terminal being 
used. 


Init calls getty with an argument specified by the /etc/ttys file entry for the terminal line. The argument 
char determines the line speed and other characteristics; see below. Getty then types a banner identifying 
the system (from /etc/whoami) and the ‘login:’ message. Then the user’s name is read, a character at a 
time. If a null character is received, it is assumed to be the result of the user pushing the ‘break’ (‘inter- 
rupt’) key. The speed is then changed to 1200 baud and the ‘login:’ is typed again; a second ‘break’ 
changes the speed to 150 baud and the ‘login:’ is typed again. Successive ‘break’ characters cycle through 
the speeds 300, 1200, and 150 baud. 


The user’s name is terminated by a new-line or carriage-return character. The latter results in the system 
being set to treat carriage returns appropriately (see ioctl(2)). 


Finally, login(8) is called with the user’s name as argument. 


Here are the possible values for char. If more than one speed is given, the first speed is used initially; oth- 
ers are selected by successive depressions of the BREAK key. Other things, like delays and tab expansion, 
are set in various ways as well. 


char speed 
300-1200-150-110 
9600 

1200-300 

300 

300-1200 

2400 

4800 

9600-300 
300-9600 

exta (usually 19200) 


OMAN ADNKRWN OS 


on. 


SEE ALSO 
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init(8), login(8), ioctl(2), ttys(5) 


ICHECK (8 ) Eighth Edition ICHECK(8) 


NAME 


icheck, dcheck, ncheck — file system consistency check 


SYNOPSIS 


/etc/icheck [ —B ] [ -s ] [ -b numbers ] [ filesystem ] 
/etc/dcheck [ -B ] [ -i numbers ] [ filesystem ] 


/etc/ncheck [ —B ] [ -i numbers ] [ -a ] [ -s ] [ filesystem ] 


DESCRIPTION 


FILES 


These programs perform consistency checks on file systems. For normal file system maintenance, see 
fsck(8). 


Icheck examines a file system, builds a bit map of used blocks, and compares this bit map against the free 
list maintained on the file system. If the file system is not specified, a set of default file systems is checked. 
The normal output of icheck includes a report of 


The total number of files and the numbers of regular, directory, block special and character special 
files. 


The total number of blocks in use and the numbers of single-, double-, and triple-indirect blocks 
and directory blocks. 


The number of free blocks. 
The number of blocks missing; i.e. not in any file nor in the free list. 


The -s option causes icheck to ignore the actual free list and reconstruct a new one by rewriting the super- 
block of the file system. The file system should be dismounted while this is done; if this is not possible (for 
example if the root file system has to be salvaged) care should be taken that the system is quiescent. The 
words in the super-block which indicate the size of the free list and of the i-list are believed. If the super- 
block has been curdled these words will have to be patched. The —-s option causes the normal output reports 
to be suppressed. 


Following the -b option is a list of block numbers; whenever any of the named blocks turns up in a file or 
the free list, a diagnostic is produced. 


Dcheck reads the directories in a file system and compares the link-count in each i-node with the number of 
directory entries by which it is referenced. The -i flag is followed by a list of i-numbers; when one of those 
i-numbers turns up in a directory, the number, the i-number of the directory, and the name of the entry are 
reported. 


Ncheck generates a pathname vs. i-number list of all files in a file system. Names of directory files are fol- 
lowed by ‘/.’. The -i option reduces the report to only those files whose i-numbers follow. The —a option 
allows printing of the names ‘.’ and ‘..’, which are ordinarily suppressed. The —s option reduces the report 
to special files and files with set-user-ID mode; it is intended to discover concealed violations of security 


policy. The report is in no useful order, and probably should be sorted. 


These programs are faster if the raw version of the special file is used, since they read the i-list many blocks 
at a time. 


If filesystem is a special file, the minor device number is checked to distinguish between regular and bit- 
mapped file systems. If the filesystem resides in a regular file, it is assumed to be a regular file system 
unless the —B option is used. 


Default file systems vary with installation. 


SEE ALSO 
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fsck(8), filsys(5), clri(8) 


ICHECK (8 ) Eighth Edition ICHECK(8) 


DIAGNOSTICS 


BUGS 


For duplicate blocks and bad blocks (which lie outside the file system) icheck announces the difficulty, the 
i-number, and the kind of block involved. Ifa read error is encountered, the block number of the bad block 
is printed and icheck considers it to contain 0. “Bad freeblock’ means that a block number outside the avail- 
able space was encountered in the free list. ‘n dups in free’ means that n blocks were found in the free list 
which duplicate blocks either in some file or in the earlier part of the free list. 


When a file turns up for which the link-count and the number of directory entries disagree, dcheck reports 
the relevant facts. Allocated files which have 0 link-count and no entries are also listed. The only danger- 
ous situation occurs when there are more entries than links; if entries are removed, so the link-count drops 
to 0, the remaining entries point to thin air. They should be removed. When there are more links than 
entries, or there is an allocated file with neither links nor entries, some disk space may be lost but the situa- 
tion will not degenerate. 


When the filesystem structure is improper, ncheck prints “??’ to denote the ‘parent’ of a parentless file. A 
pathname beginning with “...’ denotes a loop. 


Since these commands are inherently two-pass in nature, extraneous diagnostics may be produced if applied 


to active file systems. 


They believe even preposterous super-blocks and consequently can get core images. 
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INIT(8) 


NAME 


Eighth Edition INIT(8) 


init — process control initialization 


SYNOPSIS 


/etc/init 


DESCRIPTION 


FILES 


Init is invoked inside Unix as the last step in the boot procedure. It normally then runs the automatic reboot 
sequence as described in reboot(8), and if this succeeds, begins multi-user operation. If the reboot fails, it 
commences single user operation by giving the super-user a shell on the console. It is possible to pass 
parameters from the boot program to init so that single user operation is commenced immediately. When 
such single user operation is terminated by killing the single-user shell (i.e. by hitting “D), init runs /etc/rc 
without the reboot parameter. This command file performs housekeeping operations such as removing tem- 
porary files, mounting file systems, and starting daemons. 


In multi-user operation, init’s role is to create a process for each terminal port on which a user may log in. 
To begin such operations, it reads the file /etc/ttys and forks to create a process for each terminal specified 
in the file. Each of these processes opens the appropriate terminal for reading and writing on file descrip- 
tors 0, 1, 2, and 3 (the standard input and output, the diagnostic output and /dev/tty). Opening the terminal 
will usually involve a delay, since the open is not completed until someone dials and carrier is established 
on the channel. Then /efc/getty is called with argument as specified by the second character of the ftys file 
line. Getty reads the user’s name and invokes /ogin to log in the user and execute the shell. 


Ultimately the shell will terminate because of an end-of-file either typed explicitly or generated as a result 
of hanging up. The main path of init, which has been waiting for such an event, wakes up and removes the 
appropriate entry from the file uwtmp, which records current users, and makes an entry in /usr/adm/wtmp, 
which maintains a history of logins and logouts. Then the appropriate terminal is reopened and getty is 
reinvoked. 


Init catches the hangup signal (signal SIGHUP) and interprets it to mean that the file /etc/ttys should be 
read again. The shell process on each line which used to be active in ftys but is no longer there is termi- 
nated; a new process is created for each added line; lines unchanged in the file are undisturbed. Thus it is 
possible to drop or add terminal lines without rebooting the system by changing the ftys file and sending a 
hangup signal to the init process: use ‘kill —-1 1.’ 


Init will terminate multi-user operations and resume single-user mode if sent a terminate (SIGTERM, the 
default) signal, i.e. ‘kill 1’. If there are processes outstanding which are deadlocked (due to hardware or 
software failure), init will not wait for them all to die (which might take forever), but will time out after 30 
seconds and print a warning message. 


Init’s role is so critical that if it dies, the system will reboot itself automatically. If, at bootstrap time, the 
init process cannot be located, the system will loop in user mode at location 0x13. 


/dev/console, /dev/tty?, /etc/utmp, /usr/adm/wtmp, /etc/ttys, /etc/rc 


SEE ALSO 
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login(8), kill(1), sh(1), ttys(5), getty(8), re(8), reboot(8) 


LDPCS (8) Eighth Edition (VAX-11/750) LDPCS(8) 


NAME 

Idpcs — load comet microcode 
SYNOPSIS 

/etc/Idpes [ -f ] [ -v ] pcsfile 
DESCRIPTION 


Ldpcs loads microcode from pesfile into the VAX-11/750 patchable control store. Normally, the system ID 
is checked to see that the system is a 750 and that its base microcode revision level is appropriately high; 
the -f option removes the checks. The —v option causes the microcode version number to be printed after 


loading. 
Ldpcs is conventionally invoked from /etc/rc to load the most recent DEC microcode patches from 
/etc/pcs750.bin. 
FILES 
/dev/mem 
/dev/mtpr 
BUGS 


Calling /dpcs is a good idea, but it is not mandatory; the system will run without the patches. 
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LOGIN (8 ) Eighth Edition LOGIN(8) 


NAME 
login — sign on 


SYNOPSIS 
/etc/login name 
/etc/login -f name 
/etc/login —p passwd-line 


DESCRIPTION 
Login is executed by getty(8). See ‘How to Get Started’ for how to dial up initially. 


Login asks for a password if appropriate. Echoing is turned off during the typing of the password. The -f 
option forces login of the named user, without a password. —p is similar to -f but uses the supplied line of 
the password file instead of the appropriate one in /etc/passwd. Both of these options will demand a typed 
password if the named user is the super-user. 


After a successful login, accounting files are updated, the message of the day is printed, and the user is 
informed of the existence of mail. Login initializes the user and group IDs and the working directory, then 
executes a command interpreter (usually sh(1)) according to specifications found in /etc/passwd. Argument 
0 of the command interpreter is the name of the command interpreter with a leading dash (“—’) prepended. 


Login also initializes the environment with information specifying home directory, search path, and an indi- 
cation of the source of the login if appropriate. 


Only the super-user may execute login. 


FILES 
/etc/utmp accounting 
/usr/adm/wtmp accounting 
/usr/spool/mail/* mail 


/etc/motd message-of-the-day 
/etc/passwd password file 
SEE ALSO 
init(8), newgrp(1), getty(8), su(8), passwd(1) 
DIAGNOSTICS 


‘Login incorrect,’ if the name or the password is bad. 
‘No Shell’, ‘cannot open password file’, ‘no directory’: seek knowledgeable assistance. 
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LPD (8) 


NAME 


Eighth Edition LPD(8) 


Ipd — line printer daemon 


SYNOPSIS 


/etc/Ipd 


DESCRIPTION 


[pd is the daemon for the line printer. Lpd uses the directory /usr/spoollpd. The file lock in that directory 
is used to prevent two daemons from becoming active. After the program has successfully set the lock, it 
forks and the main path exits, thus spawning the daemon. The directory is scanned for files beginning with 
df. Each such file is submitted as a job. Each line of a job file must begin with a key character to specify 
what to do with the remainder of the line. 


L specifies that the remainder of the line is to be sent as a literal. 

B specifies that the rest of the line is a file name. 

F is the same as B except a form feed is prepended to the file. 

U specifies that the rest of the line is a file name. After the job has been transmitted, the file is unlinked. 
M 


is followed by a user ID; after the job is sent, a message is mailed to the user via the mail(1) com- 
mand to verify the sending of the job. 


Any error encountered will cause the daemon to wait and start over. This means that an improperly con- 
structed df file may cause the same job to be submitted repeatedly. 


[pd is automatically initiated by the line printer command, /pr. 


To restart /pd (in the case of hardware or software malfunction), it is necessary to first kill the old daemon 
(if still alive), and remove the lock file before initiating the new daemon. This is done automatically when 
the system is brought up, by /efc/rc, in case there were any jobs left in the spooling directory when the sys- 
tem last went down. 


FILES 
/usr/spool/|Ipd/* spool area for line printer daemon 
/etc/passwd to get the user’s name 
/dev/Ip line printer device 

SEE ALSO 
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Ipr(1) 


MAKEKEY (8 ) Eighth Edition MAKEKEY (8) 


NAME 

makekey — generate encryption key 
SYNOPSIS 

/usr/lib/makekey 
DESCRIPTION 


Makekey improves the usefulness of encryption schemes depending on a key by increasing the amount of 
time required to search the key space. It reads 10 bytes from its standard input, and writes 13 bytes on its 
standard output. The output depends on the input in a way intended to be difficult to compute (i.e. to 
require a substantial fraction of a second). 


The first eight input bytes (the input key) can be arbitrary ASCII characters. The last two (the salt) are best 
chosen from the set of digits, upper- and lower-case letters, and ‘.’ and ‘/’. The salt characters are repeated 
as the first two characters of the output. The remaining 11 output characters are chosen from the same set 
as the salt and constitute the output key. 


The transformation performed is essentially the following: the salt is used to select one of 4096 crypto- 
graphic machines all based on the National Bureau of Standards DES algorithm, but modified in 4096 dif- 
ferent ways. Using the input key as key, a constant string is fed into the machine and recirculated a number 
of times. The 64 bits that come out are distributed into the 66 useful key bits in the result. 


Makekey is intended for programs that perform encryption (e.g. ed and crypt(1)). Usually its input and 
output will be pipes. 


SEE ALSO 
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crypt(1), ed(1) 


MKFS (8 ) Eighth Edition MKFS(8) 


NAME 
mkfs, mkbitfs, mklost+found — construct a file system 


SYNOPSIS 
/etc/mkfs special size 


/etc/mkbitfs special size 
/etc/mklost+found 


DESCRIPTION 
Mkfs (mkbitfs) constructs a regular (bitmapped) file system by writing on the special file special. Size is the 
number of 1K (4K) blocks on the special file. The resulting file system has a single empty directory. The 
number of i-nodes is calculated as a function of the filesystem size. 


Immediately after creating a file system, mklost+found should be run to create a repository for disconnected 
files recovered by fsck(8). If the special file is /dev/disk and its mount point /mnt, mklost+found works as 
follows: 


/etc/mount /dev/disk /mnt 
cd /mnt 
/etc/mklost+found 


Mkfs (only) also has capabilities for assembling a prototype file system, but this code has not been exer- 
cised in years. 


SEE ALSO 
filsys(5), fsck(8) 


BUGS 
There should be some way to specify bad blocks. 
Mkfs and mkbitfs should make lost+found automatically. 
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MKNOD (8) Eighth Edition MKNOD(8) 


NAME 
mknod — build special file 

SYNOPSIS 
/etc/mknod name [ ¢ ] [ b ] major minor 

DESCRIPTION 
Mknod makes a special file. The first argument is the name of the entry. The second is b if the special file 
is block-type (disks, tape) or c if it is character-type (other devices). The last two arguments are numbers 
specifying the major device type and the minor device (e.g. unit, drive, or line number). 
The assignment of major device numbers is specific to each system. They have to be dug out of the system 
source file conf/devices. 

SEE ALSO 


mknod(2), config(5) 
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MOUNT (8) Eighth Edition MOUNT(8) 


NAME 


mount, umount — mount and dismount file system 


SYNOPSIS 


/etc/mount [ special name [ -r ] ] 
/etc/mount —a 
/etc/umount special 


/etc/umount —a 


DESCRIPTION 


FILES 


Mount announces to the system that a removable file system is present on the device special. The file name 
must exist already; it must be a directory (unless the root of the mounted file system is not a directory). It 
becomes the name of the newly mounted root. The optional argument -r indicates that the file system is to 
be mounted read-only. 


Umount announces to the system that the removable file system previously mounted on device special is to 
be removed. 


If the —a option is present for either mount or umount, an attempt is made to mount or dismount each of the 
file systems named in /etc/fstab. The special file name from /etc/fstab is the block special name. 


These commands maintain a table of mounted devices in /etc/mtab. If invoked without an argument, mount 
prints the table. 


Physically write-protected and magnetic tape file systems must be mounted read-only or errors will occur 
when access times are updated, whether or not any explicit write is attempted. 


/etc/mtab mount table 
/etc/fstab file system table 


SEE ALSO 


BUGS 


Page | 


mount(2), mtab(5), fstab(5), netfs(8) 


Mounting file systems full of garbage will crash the system. 
Mounting a root directory on a non-directory makes some apparently good pathnames invalid. 
These commands deal only with filesystem type 0. They should be made more general. 


NETFS (8) Eighth Edition NETFS (8) 


NAME 


netfs — network file system 


SYNOPSIS 


/usr/net/share.go 
/usr/net/share 
/usr/net/fshare 


/usr/net/pscript 


DESCRIPTION 


FILES 


BUGS 
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The network file system is conventionally a set of directories contained in /, and a set of files and pro- 
grams contained in /usr/net. 


The connections in the network file system are asymmetric, connecting a client and a server. When the 
client is connected to the server, the server’s file system appears in one of the directories in /n. The client 
establishes and maintains connections to servers using /usr/net/setup, which is started by invoking the shell 
script /usr/net/setup.go in rc(8). This program uses the file /usr/net/friends to control the connections to 
servers. Each line in /usr/net/friends contains four fields: service name, mount point, unique identifier, and 
debugging flag. The service name is the network name for the server, for instance, mh/astro/aliceF for the 
server on alice. The mount point is the name of the directory on which the remote file system is to be 
mounted, for instance /n/alice. The unique identifiers can be any integers bigger than the maximum major 
device number of a device in the system, and smaller than 255. The simplest practice is to number the lines 
consecutively starting at 64. The debugging flag is usually 0, but can be set to 3 before the connection is 
established to cause the server to store copious debugging information in a buffer, called debugbuf, which 
can be examined using pi(9.1). Setup reads the file and attempts to connect to all the servers it is not 
already connected to. If the file is changed it will be re-read within 30 seconds. Connections are tried 
every 20 minutes. If the connection exists it is tested every 30 seconds, and shut down if there is no 
response to several consecutive probes. 


The server program is /usr/net/fshare, invoked in /usr/rc by /usr/net/share.go. It runs as super-user. It uses 
a table /usr/Met/people to translate permissions between the server and its clients. The front of the file 
explains its format. The permission table is maintained by running pscript in the directory /usr/net. This 
produces a table by matching login names from the client and server password files. 


/n/* mount points for remote file systems 
/usr/net/people userid translation table 
/usr/net/friends connection list 


Group permissions are not well mapped. 


NETSTAT (8 ) Eighth Edition (research ) NETSTAT(8) 


NAME 
netstat — show network status for ARPA internet 
SYNOPSIS 
/usr/inet/bin/netstat [ —acCirs ] [ system ] [ core ] 
DESCRIPTION 
Netstat displays internet traffic and configuration data. The options are: 
-a show the known mappings between internet names and ethernet addresses. 
-c show all socket assignments. 
-C show only sockets with active connections. 
-i show the state of interfaces. 
-s show protocol statistics. 
-r show the routing tables. 


The arguments system and core are substitutes for the defaults ‘/unix’ and ‘/dev/kmem’. 


FILES 
/usr/inet/bin/netstat 
/usr/inet/lib/hosts 
/usr/inet/lib/networks 
/usr/inet/lib/services 
/anix 


DIAGNOSTICS 
‘nlist /unix failed’ — Netstat could not find pertinent kernel information. This message occurs on machines 
that can not handle internet traffic. 


SEE ALSO 
vmstat(8) 
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OOPS(8) Eighth Edition OOPS(8) 


NAME 


oops — process status 


SYNOPSIS 


oops [ acegklstuvwx# ] [ core ] [ swap ] [ namelist ] 


DESCRIPTION 
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Oops prints information about processes. Normally, only the invoker’s processes are candidates to be 
printed by oops. Specifying a causes other user’s processes to be candidates to be printed; specifying x 
includes processes without control terminals in the candidate pool. 


All output formats include, for each process, the process id PID, control terminal of the process TT, cpu 
time used by the process TIME (this includes both user and system time), the state STAT of the process, 
and an indication of the command which is running. The state is given by a sequence of four letters, e.g. 
““RWNA’’. The first letter indicates the runnability of the process: R for a runnable process, T for a 
stopped process, P for a process in page wait, D for one in disk (or other short term) wait, S for one sleep- 
ing for less than about 20 seconds, and I for an idle (sleeping longer than about 20 seconds) process. The 
second letter is W if the process is swapped out, blank if it is resident in memory. The third letter is a blank 
if the process is running with normal scheduling priority, N if the priority is reduced (nice), < if the priority 
is raised. The final letter is an A if special paging behaviour has been requested. 


Here are the options: 


a asks for information about all processes with terminals (ordinarily only one’s own processes are dis- 
played). 
c causes the system’s internal idea of the command name to be used, rather than the command argu- 


ments in the process’ address space. This is more reliable, if less informative, since the process is 
free to destroy the latter information. 


e asks for the environment (environ(7)) to be printed. 
g includes process group leaders (usually shells) which are normally excluded. 


causes the file /vmcore is used in place of /dev/kmem and /dev/mem. This is used for postmortem sys- 


tem debugging. 

1 asks for a long listing, with fields PPID, CP, PRI, NI, ADDR, SIZE, RSS and WCHAN as described 
below. 

s adds the size SSIZ of the kernel stack of each process (for use by system maintainers) to the basic 


output format. 


tx restricts output to processes whose controlling tty is x (which should be specified as printed by oops, 
e.g. ¢3 for tty3, tco for console, tdO for ttydO, t? for processes with no tty, etc). This option must be 
the last one given. 


u allegedly user oriented output is produced. This includes fields USER, %CPU, NICE, SIZE, and 
RSS as described below. 


Vv virtual memory statistics; includes fields RE, SL, PAGEIN, SIZE, RSS, SRS, TSIZ, TRS, %CPU and 
%MEM, described below. 


w use a wide output format (132 columns rather than 80); if repeated, use arbitrarily wide output. This 
information is used to decide how much of long argument lists to print. 


x asks about even processes with no terminal. 


A process number may be given, in which case the output is restricted to that process. This option 
must also be last. 


A second argument tells oops where to look for core if the k option is given, instead of Aymcore. A third 
argument is the name of a swap file to use instead of the default /dev/drum. If a fourth argument is given, it 
is taken to be the file containing the system’s namelist. Otherwise, /unix is used. 
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FILES 
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Fields which are not common to all output formats: 


USER 
YoCPU 


SL 
PAGEIN 
UID 
PPID 


the owner of the process 

cpu utilization of the process; this is a decaying average over up to a minute of previous (real) 
time. Since the time base over which this is computed varies (since processes may be very 
young) it is possible for the sum of all %CPU fields to exceed 100%. 

(or NI) process scheduling increment (see nice(2)) 

virtual size of the process (in 1024 byte units) 

real memory (resident set) size of the process (in 1024 byte units) 

number of real memory pages (RSS) if and when swapped 

size of text (shared program) image 

size of resident (real memory) set of text 

percentage of real memory used by this process. 

residency time of the process (seconds in core) 

sleep time of the process (seconds blocked) 

number of disk i/o’s resulting from references by the process to pages not loaded in core. 
numerical user-id of process owner 

numerical id of parent of process 

short-term cpu utilization factor (used in scheduling) 

process priority (non-positive when in non-interruptible wait) 

swap address of the process 

event on which process is waiting (an address in the system), with the initial part of the address 
trimmed off; e.g. 0x80004000 prints as 4000. 


flags associated with process as in /media/acher/Games/v8/ustr/include/sys/proc.h: 


SLOAD 000001 in core 

SSYS 000002 swapper or pager process 
SLOCK 000004 process being swapped out 
SSWAP 000008 _ save area flag 

STRC 000010 process is being traced 
SWTED 000020 another tracing flag 
SULOCK 000040 user settable lock in core 
SPAGE 000080 process in page wait state 
SKEEP 000100 another flag to prevent swap out 
SDLYU 000200 delayed unlock of pages 
SWEXIT 000400 working on exiting 
SPHYSIO 000800 doing physical i/o (bio.c) 


SPAGI 008000 init data space on demand, from inode 
SSEQL 010000 user warned of sequential vm behavior 
SUANOM ~— 020000 user warned of anomalous vm behavior 
STIMO 040000 timing out during sleep 


SDETACH = 080000 detached inherited by init 
SNUSIG 100000 using new signal mechanism 


A process that has exited and has a parent, but has not yet been waited for by the parent is marked 
<defunct>; a process which is blocked trying to exit is marked <exiting>. Oops makes an educated guess 
as to the file name and arguments given when the process was created by examining memory or the swap 
area. The method is inherently somewhat unreliable and in any event a process is entitled to destroy this 
information, so the names cannot be counted on too much. 


/unix 


system namelist 


/dev/kmem kernel memory 


/dev/drum 
/vymcore 
/dev 


swap device 
core file 
searched to find swap device and tty names 
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SEE ALSO 
kill(1), ps(1), pstat(8) 


BUGS 
Things can change while oops is running; the picture it gives is only a close approximation to reality. 
Oops duplicates ps(1); it is useful mainly for examining kernel crash dumps, or when /proc is not mounted. 
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NAME 
pstat — print system facts 


SYNOPSIS 
/etc/pstat [ —acfipstuxT ] [ suboptions ] [ file ] [ namelist ] 


DESCRIPTION 
Pstat interprets the contents of certain system tables. If file is given, the tables are sought there, otherwise 
in /dev/kmem. The required namelist is taken from namelist, default /unix. Options are 


-a Under —p, describe all process slots rather than just active ones. 
-i Print the inode table with the these headings: 


LOC The core location of this table entry. 
FLAGS Miscellaneous state variables encoded thus: 
locked 
update time (filsys(5)) must be corrected 
access time must be corrected 
file system is mounted here 
wanted by another process (L flag is on) 
contains a text file 
changed time must be corrected 
CNT Number of open file table entries for this inode. 
DEV Major and minor device number of file system in which this inode resides. 
INO I-number within the device. 
MODE Mode bits, see chmod(2). 
NLK Number of links to this inode. 
UID User ID of owner. 
SIZ/DEV 
Number of bytes in an ordinary file, or major and minor device of special file. 


Q4HsZrpar 


-x Print the text table with these headings: 


LOC The core location of this table entry. 

FLAGS Miscellaneous state variables encoded thus: 

Traced through proc (4) 

text not yet written on swap device 

loading in progress 

locked 

wanted (L flag is on) 

resulted from demand-page-from-inode exec format (see exec (2)) 


MEAs 


DADDR Disk address in swap, measured in multiples of 512 bytes. 
CADDR Head of a linked list of loaded processes using this text segment. 
SIZE Size of text segment, measured in multiples of 512 bytes. 

IPTR Core location of corresponding inode. 

CNT Number of processes using this text segment. 

CCNT Number of processes in core using this text segment. 

-p Print process table for active processes with these headings: 


LOC The core location of this table entry. 


S Run state encoded thus: 
0 no process 
1 waiting for some event 
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runnable 
being created 
being terminated 
stopped under trace 
F Miscellaneous state variables, or-ed together (hexadecimal): 
000001 loaded 
000002 the scheduler process 
000004 = locked for swap out 
000008 = swapped out 
000010 traced 
000020 used in tracing 
000080 in page-wait 
000100 = prevented from swapping during fork(2) 
000200 gathering pages for raw i/o 
000400 exiting 
008000 process is demand paging data pages from its text inode. 
030000 process has warned of anomalous paging behavior with vlimit(2). 
040000 __ process is in a sleep which will timeout. 
080000 a parent of this process has exited and this process is now considered detached. 
POIP number of pages currently being pushed out from this process. 
PRI Scheduling priority, see nice (2). 
SIGNAL Signals received (signals 1-32 coded in bits 0-31), 
UID Real user ID. 


Dons W 


SLP Amount of time process has been blocked. 

TIM Time resident in seconds; times over 127 coded as 127. 
CPU Weighted integral of CPU time, for scheduler. 

NI Nice level, see nice(2). 


PGRP Process number of root of process group (the opener of the controlling terminal). 

PID The process ID number. 

PPID The process ID of parent process. 

ADDR If in core, the page frame number of the first page of the ‘u-area’ of the process. If swapped out, 
the position in the swap area measured in multiples of 512 bytes. 

RSS Resident set size — the number of physical page frames allocated to this process. 

SRSS_ __ RSS at last swap (0 if never swapped). 

SIZE Virtual size of process image (data+stack) in multiples of 512 bytes. 

WCHAN 
Wait channel number of a waiting process. 

LINK _ Link pointer in list of runnable processes. 

TEXTP If text is pure, pointer to location of text table entry. 

CLKT Countdown for alarm(2) measured in seconds. 


-u print information about a user process; the next argument is its address as given by oops(8). The 
process must be in main memory, or the file used can be a core image and the address 0. 


-f Print the open file table with these headings: 
LOC The core location of this table entry. 
FLG Miscellaneous state variables encoded thus: 
R open for reading 
W open for writing 
P pipe 


CNT Number of processes that know this open file. 
INO The location of the inode table entry for this file. 
OFFS The file offset, see /seek(2). 
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—s print information about swap space usage: the number of (1k byte) pages used and free is given as well 
as the number of used pages which belong to text images. 


-T prints the number of used and free slots in the several system tables and is useful for checking to see 
how full system tables have become if the system is under heavy load. 


FILES 

/unix namelist 

/dev/kmem default source of tables 
SEE ALSO 


oops(8), stat(2), filsys(5) 
K. Thompson, UNIX Implementation 


BUGS 
This program is never up to date. 
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NAME 

quot — summarize file system ownership 
SYNOPSIS 

/etc/quot [ option ] ... [ filesystem ] 
DESCRIPTION 


Quot prints the number of blocks in the named filesystem currently owned by each user. If no filesystem is 
named, a default name is assumed. The following options are available: 


—n Cause the pipeline ncheck filesystem | sort +0n | quot —n filesystem to produce a list of all files 
and their owners. 


—c Print three columns giving file size in blocks, number of files of that size, and cumulative total of 
blocks in that size or smaller file. 


-f Print count of number of files as well as space owned by each user. 

-b Print space-time product in block-years in addition to space owned by each user. 
FILES 

Default file system varies with system. 

/etc/passwd to get user names 
SEE ALSO 


Is(1), du(1) 


BUGS 
Holes in files are counted as if they actually occupied space. 
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NAME 


rarepl, rarct — replace bad blocks on MSCP disks 


SYNOPSIS 


/etc/rarct [ -c ] [-h ] special ... 
/etc/rarepl special Ibn ... 


DESCRIPTION 


Rarct prints status information about MSCP disk drives (drives such as the RA60 and RA81 on controllers 
like the UDA50). Normally the replacement table (RCT) is listed, as lines of the form 


rbn: flags: Ibn 


where rbn is the replacement block number, /bn is the logical block number replaced by rbn, and flags are 
constructed from the following bits: 


Ol alternate (not primary) replacement block 
02 normal, allocated replacement block 

04 this replacement block is bad 

010 this replacement block does not exist 


Entries whose flags are zero, indicating a good, unused replacement block, are not listed. 


The —h option prints some header data from the first block of the RCT. UNIX makes no use of this info. 
—c prints geometry info for the drive. Either option suppresses the RCT listing. 


Rarepl causes logical block /bn on device dev to be marked as bad and replaced. The nearest available 
replacement block is used. The contents of /bn are copied into the replacement block if possible; if /bn is 
unreadable, the replacement block is initialized with zeroes. 


Both programs work only on the raw devices. Rarepl should be used only on a device which covers the 
entire drive (usually partition 7). 


SEE ALSO 


BUGS 
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On the UDAS0O, the RCT exists only so programs in the host can look at it; the controller ignores its con- 
tents. There is no way to read the controller’s ‘real’ forwarding data, only a way to set it for a particular 
block. Hence if the RCT is corrupted, the disk may still be used, but must be reformatted before additional 
bad blocks are remapped. 


RC(8) 
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NAME 
rc — boot script 

SYNOPSIS 
/ete/re 

DESCRIPTION 
Rc is the command script invoked by init(8) to control reboots. During an automatic reboot, rc is invoked 
with the argument autoboot; typically this invokes /etc/fsck —p to repair minor filesystem inconsistencies. 
If rc exits with an unsuccessful status, init stops in single-user mode; otherwise it proceeds to multi-user. 
When the system enters multi-user mode, either during an auto-reboot or after the single-user shell termi- 
nates, rc is invoked without arguments. This usually causes it to mount filesystems, start daemons, clear 
/tmp, and perform other housekeeping. If this call to rc exits unsuccessfully, init reverts to single-user 
mode. 

SEE ALSO 
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init(8), reboot(8) 
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NAME 


reboot — bootstrapping procedures 


SYNOPSIS 


/etc/reboot [ -s ] [-n ] [-a] [-d ] 
/etc/halt [ —n ] 


DESCRIPTION 
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UNIX is started by placing it in memory at location zero and transferring to zero. Since the system is not 
reenterable, it is necessary to read it in from disk each time it is to be bootstrapped. 


Rebooting a running system 


The preferred way to reboot is to log in on the console, invoke kill 1 to take the system to single user, 
unmount filesystems with /etc/umount —-a and halt and restart the system as described below under 
Console boots. 


If access to the console is difficult, /etc/reboot may be used to restart a running system. It normally syncs 
the disks (see sync(8)), then causes a system boot and an automatic disk check. If all this succeeds, the sys- 
tem is brought up multi-user. 


The options to reboot are: 


-Ss Come up single-user after the reboot, without checking the disks. 
—n Don’t sync the disks before performing the reboot. 

-a Ask on the console for the name of the file to be booted. 

-d Write a crash dump to the swap area before rebooting. 


/etc/halt syncs the disks and stops the CPU. If the —n option is enabled, the disk sync is not performed. 


Power fail and crash recovery 


The system will normally reboot itself at power-up or after crashes if the auto-restart is enabled on the 
machine front panel. An automatic consistency check of the file systems is performed. Unless this fails the 
system will resume multi-user operations. 


Console boots: VAX-11/750 


Sync the disks if necessary and possible. To recover control of the console (normally it is running as an 
ordinary Unix terminal), type a control-P. This will halt the CPU and yield a ‘>>>’ prompt from the VAX 
console subsystem (sic). (Under undocumented conditions, this may fail. If so, hit the white button on the 
front panel.) The command 


>>>B 
will cause a normal automatic reboot. Use 
>>> B/3 


to come up single-user. This also will prompt (with ‘:’) for the name of the file to boot. The format of the 
file name is 


disk(m, n)file 


where disk is ‘ra’ for UDA50 disks with 4KB filesystems, ‘sa’ for UDASO disks with 1KB filesystems, ‘up’ 
for UNIBUS SMD disks, ‘hp’ for Massbus SMD disks; m is the drive number (usually 0); 7 is the file sys- 
tem number on the drive (usually 0); and file is the Unix name of the file on the disk. 


If the root disk is curdled, the bootstrap program /boot can be read from another disk, say RA drive 1, by 


REBOOT (8 ) Eighth Edition REBOOT(8) 


>>> B/3 DUAI 


To the console subsystem, the RA’s are called DU; the Emulex disks are EM. Note that regardless how a 
system is bootstrapped, it will use drive 0 for the root disk. 


Console boots: VAX-11/780 

To halt a 780, type control-P, then issue the command 
>>> H 

to halt the CPU. 

Rebooting a 780 is like a 750 except for the format of the B command. 
>>> B 

initiates automatic reboot. 
>>> B ANY 


comes up single user. Replace ‘ANY’ by ‘HPS’ for hp disk single user reboot, ‘RPS’ for rp reboot, and 
‘UPS’ for ra reboot. 


Generating system core images 


If the system crashes, it attempts to save a copy of its physical memory to the swap area, to be copied to the 
file system after reboot (see savecore(8)). To save a core image for a hung system, type on the console 
(after control-P if necessary): 


>>> I 
>>> S$ C00 


This resets the bus and jumps to the start of the dumping code. The system will reboot automatically. 


Examining system core images 


Savecore saves in the dump directory two files: the copy of physical memory, called vmcore.n, and a copy 
of the kernel binary unix.n, where n is a sequence counter. To recover a stack traceback at the time of the 
crash, type 


$ adb unix.n vmcore.n 


$<crash 
$c 
Pi(9.1) can examine kernel core dumps. 
FILES 
/anix default Unix kernel binary 
/boot system bootstrap 
SEE ALSO 
fsck(8), init(8), rc(8) 
BUGS 


Our homemade boot ROM for Emulex disks always boots from drive 0, no matter what you tell it. 
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NAME 
renice — alter priority of running process by changing nice 

SYNOPSIS 
/etc/renice [ —pri ] pid ... 

DESCRIPTION 
Renice alters the priority of the process with process-id pid. The default pri is 19. Changing the priority 
requires permission to write /proc/pid (see proc(4)), so only the super-user can alter an arbitrary process’s 
priority. Only the super-user can raise a process’s priority. 

FILES 
/proc/pid 

SEE ALSO 


nice(1), nice(2), proc(4) 
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NAME 
rmdir — unlink directory 


SYNOPSIS 
rmdir name... 


DESCRIPTION 
Rmdir removes the named directories, which must be empty. Doing so requires super-user privilege. 
Rmdir is separate from, but called by rm(1). 
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sa, accton — system accounting 


SYNOPSIS 


/etc/sa [ -abcdDfgijkKInrstuv | [ -e prefix | [ file ] 


/etc/accton [ file ] 


DESCRIPTION 
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With an argument naming an existing file, accton causes system accounting information for every process 
executed to be placed at the end of the file. If no argument is given, accounting is turned off. 


Sa reports on, cleans up, and generally maintains accounting files. 


Sa is able to condense the information in /usr/adm/acct into a summary file /usr/adm/savacct which con- 
tains a count of the number of times each command was called and the time resources consumed. This con- 
densation is desirable because on a large system /usr/adm/acct can grow by 10000 blocks per day. The 
summary file is normally read before the accounting file, so the reports include all available information. 


If a file name is given as the last argument, that file will be treated as the accounting file; /usr/adm/acct is 
the default. 


Output fields are labelled: ‘cpu’ for the sum of user+system time (in minutes), ‘re’ for real time (also in 
minutes), ‘k’ for cpu-time averaged core usage (in 1k units), ‘avio’ for average number of IO operations per 
execution. With options fields labelled ‘tio’ for total IO operations, ‘k*sec’ for cpu storage integral (kilo- 
core seconds), ‘u’ and ‘s’ for user and system cpu time alone (both in minutes) will sometimes appear. 


There are zillions of options: 


a Place all command names containing unprintable characters and those used only once under the 
name ‘***other.’ 


b Sort output by sum of user and system time divided by number of calls. Default sort is by sum of 
user and system times. 


¢c Besides total user, system, and real time for each command print percentage of total time over all 
commands. 

d Sort by average number of disk IO operations. 

D Sort by total number of disk IO operations. 

e Set the prefix for accounting file names to the next argument (/usr/adm/ is the default). 

f Force no interactive threshold compression with —v flag. 

g Ignore /usr/adm/acct. Useful for processing only savacct and usracct. 

i Don’t read in summary file. 

j Instead of total minutes time for each category, give seconds per call. 

k Sort by cpu-time average memory usage. 

K Print and sort by cpu-storage integral. 

1 Separate system and user time; normally they are combined. 

m (money) Print number of processes and number of CPU minutes for each user. 

n Sort by number of calls. 

r Reverse order of sort. 

S Merge accounting file into summary file /usr/adm/savacct when done. 

t For each command report ratio of real time to the sum of user and system times. 

u Superseding all other flags, print for each command in the accounting file the user ID and com- 


mand name. 
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Vv Followed by a number n, types the name of each command used n times or fewer. Await a reply 
from the terminal; if it begins with ‘y’, add the command to the category ‘**junk**.’ This is used 
to strip out garbage. 


FILES 
/usr/adm/acct raw accounting 
/usr/adm/savacct summary 
/usr/adm/usracct per-user summary 
SEE ALSO 
ac(8), acct(2) 
BUGS 


Needs more options. 
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NAME 
savecore — save a core dump of the operating system 


SYNOPSIS 
/etc/savecore dirname [ unix | 


DESCRIPTION 
Savecore saves a copy of the physical memory of the operating system, saved after a system crash. It is 
meant to be called from rc(8) after normal filesystems are mounted. 


Savecore checks the core dump to be certain it corresponds with the named unix (default ‘/unix’). If it does 
it saves the core image in the file dirname/core.n and its sibling, the namelist, in dirname/unix.n. The trail- 
ing ‘.n’ in the pathnames is replaced by a number stored in dirname/bounds which grows every time 
savecore is run with the same dirname argument. 


Before savecore writes out a core image, it reads a number from the file dirname/minfree. If there are 
fewer free kilobytes on the filesystem which contains dirname than the number obtained from the minfree 
file, the core dump is not done. If the minfree file does not exist, savecore always writes out the core file 
(assuming that a core dump was taken). 


FILES 
/anix current unix binary 
dirname /bounds numerical suffix 
dirname /minfree minimum free kilobytes required 
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NAME 
showg — state of stream I/O system 
SYNOPSIS 
/etc/showg [ -v -V -s —m ] [ system ] [ mem ] 
DESCRIPTION 
Showg reports connectivity and contents of I/O streams. By default, it lists the maximum number of stream 
blocks (of various sizes) ever used, then each stream and the queue modules in each stream, and then blocks 
that are unaccounted for (not on any queue or the free list). 
By default, the system namelist is /unix and the place the streams are kept is /dev/mem. 
These flags are understood: 
-vV Verbose. Show more, in particular the contents of data and control blocks on each queue. 
-V Very verbose. Show all blocks on every queue instead of giving up after a while. 
-s Silent. Examine queues for consistency, printing only a summary. 
—m Missing. Show the contents of missing blocks. (Perhaps this will give a clue about who lost 
them.) 
FILES 


/unix, /dev/mem 
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NAME 
su — substitute user id temporarily 


SYNOPSIS 
/etc/su [ user | 


DESCRIPTION 
Su demands the password for the login name user, and if it is given, changes to that userid and invokes the 
Shell si(1) without changing the current directory. The user environment is unchanged except for HOME 
and SHELL, which are taken from the password file for the user being substituted (see environ(5)). The 
new userid stays in force until the Shell exits. 


If no user is specified, ‘root’ is assumed. To remind the super-user of his responsibilities, the Shell substi- 
tutes “# for its usual prompt. 


SEE ALSO 
sh(1) 
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NAME 
swapon — specify paging/swapping device 


SYNOPSIS 
/etc/swapon —a 
/etc/swapon name ... 


DESCRIPTION 
Swapon is used to specify additional devices on which paging and swapping are to take place. The system 
begins by swapping and paging on a single device so that only one disk is required at bootstrap time. Calls 
to swapon normally occur in the system multi-user initialization file rc(8) making all swap devices avail- 
able, so that the paging and swapping activity is interleaved across several devices. 


‘ 


Normally, the -a argument is given, causing all devices marked as 
made available. 


“sw’’ swap devices in /etc/fstab to be 


The second form gives individual block devices as given in the system swap configuration table. The call 
makes only this space available to the system for swap allocation. 


SEE ALSO 

init(8) 
FILES 

/dev/ra? 1 normal paging devices 
BUGS 


There is no way to stop paging and swapping on a device. It is therefore not possible to make use of 
devices which may be dismounted during system operation. 
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NAME 
sync — update the super block 


SYNOPSIS 
sync 


DESCRIPTION 
Sync executes the sync system primitive. Sync can be called to insure all disk writes have been completed 


before the processor is halted manually. 


SEE ALSO 
sync(2), reboot(8), update(8) 
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upas — address driven mailer 


SYNOPSIS 


mail person ... 
rmail —N network person ... 
cmail —N network person ... 


DESCRIPTION 


FILES 


Upas is a mail delivery system that disposes of messages in a way determined by the destination address 
and a set of rewriting rules. It can be used to recognize many address formats and route remote mail to dif- 
ferent network mail interfaces. 


mail is used by a user to send or read mail. See mail(1). 


rmail is used to inject mail coming from other machines into the mail system. No message conversion is 
performed. 


cmail is used to inject mail formatted according to ARPA RFC 822 into the mail system. The mail is 
converted into a form understandable to upas. 


Upas’s rewriting rules (mail(7)) contain ed(1) style substitutions that allow addresses to be transformed 
into the commands used to inject mail to the networks. 


The —N option causes the ‘network’ indicates the name of the network from which the message is coming. 
This network name is prepended to the return address. 


Each message submitted using rmail or cmail is checked against a forwarding list. Unless the name of all 
machines in the source path or all machines in the destination path are in the forwarding list, the message is 
refused. 


/usr/lib/upas/rewrite the rewriting rules 
/usr/lib/upas/forwardlist the forwarding list 
/usr/lib/upas/forwardlist.lolocal forwarding list 


/bin/mail the mailer program 
/bin/rmail linked to /bin/mail 
/bin/cmail linked to /bin/mail 
/usr/spool/mail/* mailboxes 
/etc/passwd authentication 
/tmp/ma* temp file 

/tmp/ml* lock file 


$HOME/dead. letter unmailable text 


SEE ALSO 
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xsend(1), write(1), uucp(1), mail(1), mail(7) 


UPDATE(8) Eighth Edition UPDATE(8) 


NAME 
update — periodically update the super block 


SYNOPSIS 
/etc/update 


DESCRIPTION 
Update is a program that executes the sync(2) primitive every 30 seconds. This insures that the file system 
is fairly up to date in case of a crash. This command should not be executed directly, but rather out of the 
initialization shell command file rc(8). 


SEE ALSO 
sync(2), sync(8), init(8) 
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UUCHECK (8) Eighth Edition UUCHECK(8) 


NAME 

uucheck — check uucp directories and permissions file 
SYNOPSIS 

/usr/lib/uucp/uucheck [ —v | [ -x debug_ level ] 
DESCRIPTION 


Uucheck checks for the presence of files and directories used by programs associated with uucp (1). It also 
checks for some obvious errors in the Permissions file. When executed with the —v option, it gives a 
detailed explanation of how the programs will interpret the Permissions file. 


The —x option requests deugging output. Debug level is a single digit; higher numbers give more detail. 


FILES 
/usr/lib/uucp/Systems 
/usr/lib/uucp/Permissions 
/usr/lib/uucp/Devices 
/usr/lib/uucp/Maxuuxqts 
/usr/lib/aucp/Maxuuscheds 
/ustr/spool/uucp/* 
/ustr/spool/uucppublic/* 


SEE ALSO 
uucp(1) 


BUGS 
The program doesn’t check file/directory modes or some errors in the Permissions file such as duplicate 
login or machine name. 
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UUCICO (8 ) Eighth Edition UUCICO(8) 


NAME 
uucico — file transport program for the uucp system 


SYNOPSIS 
/usr/lib/uucp/uucico [ -r1 -s system_name ] [ —x debug_level ] | -d spool_directory ] 
/usr/lib/uucp/kick system 
/usr/lib/uucp/debug system 


DESCRIPTION 
Uucico transfers files between systems for uucp(1). It is normally invoked by /ogin for an incoming con- 
nection (a slave), or by uusched(8) to call out to another system (a master). 


The -r1 option causes it to act as a master. In this case, -s must be given to name the system to be called. 
If -r1 is not present, uucico goes into slave mode, and assumes that a master will talk to it on standard 
input and output. 


-x turns on debugging output; debug level is a single digit. Larger numbers request greater loquacious- 
ness. 


Kick invokes uucico in the background to call out to the specified system. Debug causes a call with a mod- 
erate amount of debugging output (-x4). Both attempt to remove existing system status information for 
system, so that a call will be attempted regardless of recent failures. 


FILES 
/usr/lib/uucp/Systems 
/usr/lib/uucp/Permissions 
/asr/lib/uucp/Devices 
/usr/lib/uucp/Maxuuxqts 
/usr/lib/uucp/Maxuuscheds 
/usr/spool/uucp/* 
/usr/spool/uucppublic/* 


SEE ALSO 
uucp(1), uustat(1), uusched(8) 
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UUCLEANUP(8 ) 


Eighth Edition UUCLEANUP(8) 


NAME 

uucleanup — uucp spool directory clean-up 
SYNOPSIS 

/usr/lib/uucp/uucleanup [ options ] 
DESCRIPTION 

Uucleanup removes old files from the uucp spool directories. It is controlled by a number of options: 

—Cdays Remove B C. files that are at least days old, and send a message to the user who queued the 
job. 

-Ddays Remove D. files that are at least days old. If the data file appears to contain a mail message, 
an attempt will be made to deliver it; if it contains a netnews article from another system, it 
will be handed to rnews. 

—-Wdays Send a warning to the user who queued any jobs (C. files) at least days old. If one of the 
data files for the job appears to be a mail message, the message is included in the warning. 

—Xdays Remove any X. files at least days old. 

—mstring Include string in warning messages. The default is ‘‘See your local administrator to locate 
the problem.”’ 

—odays Remove any other files that are at least days old. 

—ssystem Examine only files associated with system. 


cron(8). 
FILES 

/usr/lib/uucp 
SEE ALSO 

uucp(1) 
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By default, C. files generate a warning when one day old, and are removed after 7 days; D. files are 
removed after 7 days; and X. and other files are removed after 2 days. 


This program is typically called by the shell uudemon.cleanup, which should be started regularly by 


directory with commands used by uucleanup internally 


/ust/spool/aucp spool directory 


UUSCHED (8) Eighth Edition UUSCHED(8) 


NAME 


uusched — uucp file transport scheduler 


SYNOPSIS 


/usr/lib/uucp/uusched [ —x debug _ level ] [ -u debug level ] 


DESCRIPTION 


FILES 


Uusched examines the uucp spool directories, and invokes uucico (&) for each system with work pending. 
It is called by uwucp and uux(1) after work is queued, and should be invoked regularly (usually hourly) by 
cron(8). 


A limited number of copies of uusched are permitted at any time. The number is kept in the file 
/ust/lib/uucp/Maxuuscheds . 


The two options are for debugging purposes only. —x requests debugging output; debug level is a single 
digit, larger numbers producing more detailed output. —u debug_level causes —x debug _ level to be passed 
to uucico. 


/usr/lib/uucp/Systems 
/usr/lib/uucp/Permissions 
/usr/lib/uucp/Devices 
/ustr/spool/uucp/* 
/ust/spool/uucp/LCK* 
/ust/spool/uucppublic/* 


SEE ALSO 
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uucp(1), uux(1), uucico(8) 


UUXQT(8) Eighth Edition UUXQT(8) 


NAME 


uuxqt — execute remote command requests 


SYNOPSIS 


/usr/lib/uucp/uuxat [ -s system ] [ -x debug_level ] 


DESCRIPTION 


FILES 


Uuxqt executes remote command requests generated by uux(1). It searches the uucp spool directories look- 
ing for filenames starting with X, checks to see that all required data files are available and accessible and 
that the requested command is permitted for the requesting system, and invokes the command if all is well. 
The Permissions file is used to validate file accessibility and command execution permission. 


Before the command is invoked, the environment variable UU_MACHINE is set to the name of the 
machine that sent the job (the previous one); UU_USER is the user that sent the job. These can be used in 
writing remote commands that provide information, auditing, or restrictions. PATH is set to /bin:/usr/bin; 
USER is set to uucp . The file creation mask (umask (2)) is set to 0. 


A limited number of copies of wuxqt are allowed to exist at a given time; the number lives in the file 
/usr/lib/uucp/Maxuuxdts . 


/usr/lib/uucp/Permissions 
/usr/lib/uucp/Maxuuxqts 
/ustr/spool/uucp/* 
/ust/spool/uucp/LCK* 


SEE ALSO 
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uucp(1), uux(1), uucico(8), uustat(1) 


VMSTAT(8 ) Eighth Edition VMSTAT(8) 


NAME 


vmstat — report virtual memory statistics 


SYNOPSIS 


vmstat [ —fs ] [ interval [ count ] ] 


DESCRIPTION 


FILES 
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Vmstat normally reports certain statistics kept about process, virtual memory, disk, trap and cpu activity. 
Option -f reports on forks since system startup and the number of pages of virtual memory involved. 
Option -s reports on paging events since boot. 


In the absence of other options, the optional interval argument causes vmstat to report once each interval 
seconds, repeated count times or forever. 


The default format fields are: 


Procs: information about numbers of processes in various states. 


R in run queue 
B blocked for resources (i/o, paging, etc.) 
W runnable or short sleeper (< 20 secs) but swapped 


Memory: usage of virtual and real memory. ‘Active’ virtual pages belong do processes that have run in the 
last 20 seconds. 

AVM _active virtual pages 

FRE size of the free list 


Page: paging activity, averaged each five seconds, and given in units per second. 


RE page reclaims (simulating reference bits) 
PI page-in events 

PO page-out events 

FR pages freed per second 

DE anticipated short term memory shortfall 
SR scan rate: pageout daemon rpm 


Disk: operations per second. Typically paging is split across several drives. The drive names are ephem- 
eral: ask a guru. 


Faults: trap/interrupt rate averages per second over last 5 seconds. 


IN (non clock) device interrupts per second 
SY system calls per second 

PD pseudo-dma interrupts on DZ 

CS cpu context switch rate (switches/sec) 


Cpu: breakdown of percentage usage of CPU time 

US user time for normal and low priority processes 
SY system time 

ID cpu idle 


/dev/kmem, /unix 


WALL(8) Eighth Edition WALL(8) 


NAME 
wall — write to all users 
SYNOPSIS 
/etc/wall 
DESCRIPTION 
Wall reads its standard input until an end-of-file. It then sends this message, preceded by ‘Broadcast Mes- 
sage ...’, to all logged in users. 
The sender should be super-user to override any protections the users may have invoked. 
FILES 
/dev/tty? 
/etc/utmp 
SEE ALSO 
mesg(1), write(1) 
DIAGNOSTICS 


“Cannot send to ...’ when the open on a user’s tty file fails. 
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XSTR (8) Eighth Edition XSTR(8) 


NAME 


xstr — preprocessor for sharing strings in C programs 


SYNOPSIS 


xstr [-c ] [-] [ file ] 


DESCRIPTION 


FILES 


BUGS 
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Xstr maintains a file strings into which strings in component parts of a large program are hashed. These 
strings are replaced with references to this common area. This serves to implement shared constant strings, 
most useful if they are also read-only. 


The command 
xstr -—c name 


will extract the strings from the C source in name, replacing string references by expressions of the form 
(&xstr[number]) for some number. An appropriate declaration of xstr is prepended to the file. The result- 
ing C text is placed in the file x.c, to then be compiled. The strings from this file are placed in the strings 
data base if they are not there already. Repeated strings and strings which are suffices of existing strings do 
not cause changes to the data base. 


After all components of a large program have been compiled a file xs.c declaring the common xstr space 
can be created by a command of the form 


xstr 


This xs.c file should then be compiled and loaded with the rest of the program. If possible, the array can be 
made read-only (shared) saving space and swap overhead. 


Xstr can also be used on a single file. A command 
xstr name 
creates files x.c and xs.c as before, without using or affecting any strings file in the same directory. 


It may be useful to run xstr after the C preprocessor if any macro definitions yield strings or if there is con- 
ditional code which contains strings which may not, in fact, be needed. Xstr reads from its standard input 
when the argument ‘—’ is given. An appropriate command sequence for running xstr after the C preproces- 
sor iS: 


cc —E name.c | xstr -—c — 
cc -C X.c 
mv X.o name.o 


Xstr does not touch the file strings unless new items are added, thus make can avoid remaking xs.o unless 
truly necessary. 


strings Data base of strings 
X.C Massaged C source 
XS.C C source for definition of array ‘xstr’ 


/tmp/xs* Temp file when “xstr name’ doesn’t touch strings 


If a string is a suffix of another string in the data base, but the shorter string is seen first by xstr both strings 
will be placed in the data base, when just placing the longer one there will do. 


INTRO (9) Eighth Edition INTRO(9) 


NAME 


intro — introduction to jerq-related software 


DESCRIPTION 


Section 9 of this manual lists software for running or supporting Teletype DMD-5620 terminals, the current 
implementation of the ‘jerq’ graphics terminals. Subsections 9.1-9.7 mirror the purposes of the preceding 
sections 1-7, with 9.1 being commands, 9.6 being games, etc. 


The only ‘real’ 5620 commands are 32/d, which loads programs into the terminal, and mux, which starts the 
characteristic ‘layer’ or window system. The other commands in section 9 either run on Unix or within 
mux layers. 


A layer is technically a virtual terminal, but is almost indistinguishable in software from a real terminal; in 
particular, the interface described in tty/d(4) applies to layers, except for the additional editing capabilities 
discussed in mux(9.1). 


The commands in sections 9.1 and 9.6 run on Unix, but most also call 32/d to “‘down-load’ a program that 
replaces the default terminal process running in the layer, that is, the command’s controlling teletype. To 
Unix the interface is still that of a terminal; in particular /dev/tty is always connected to the layer. The 
default mux terminal program implements the teletype function itself, but when a program is down-loaded a 
teletype line discipline is pushed on the stream (see stream(4) and ttyld(4)). Some commands may simply 
emulate other terminals by down-loading a terminal program (see term(9.1); others, such as the text editor 
jim(9.1), are really two programs — one on Unix and one in the layer — communicating using standard 
input/output on Unix and sendchar/rcvchar in the terminal; see request(9.2). 


There is an identity between bitmaps and layers in the graphics software. The objects of jerq graphics are 
bitmaps. The primitives that operate on layers are aliased to the bitmap primitives, and the data structures 
are isomorphic. When running under mux, a programmer need not consider layers as graphical objects at 
all; the operating system checks the arguments to the graphics primitives and dispatches the appropriate 
operator depending on the type of the argument. Except in stand-alone software, layers are an invisible 
implementation detail. 


SEE ALSO 
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321d(9.1), mux(9.1), stream(4), pt(4) 


32LD(9.1) Eighth Edition 32LD(9.1) 


NAME 

321d — bootstrap loader for 5620 
SYNOPSIS 

321d [ option ... ] file [ arguments ] 
DESCRIPTION 


32Id loads the named file for execution in the 5620 connected to its standard output. If running under 
mux(9.1), the arguments are passed, as in Unix, to the program. File must be a MAC-32 object file. 32/d 
does all necessary bootstrap and protocol procedures. There are several options. 


-d prints on the diagnostic output (which must be separated from the standard output to avoid cor- 
rupting the down-load) the sizes of the text, data and bss portions of file. 


-p prints down-loading protocol statistics on the diagnostic output (for stand-alone loads only). 

-r causes file to be relocated to an address established by a separate protocol during bootstrap. It is 
invoked automatically when loading a process into mux(9.1), and usually need not be set explic- 
itly. 

-Z loads the process but doesn’t run it, so it must be started using 3pi(9.1). It works only under 
mux (9.1). 


The environment variable JPATH is the analog of the shell’s PATH variable to define a set of directories in 
which to search for file. 


SEE ALSO 
jx(9.1), mux(9.1) 


Page | 


3CC (9.1) Eighth Edition 3CC(9.1) 


NAME 
3cc, 3as, 3ar, 3nm, 3size, 3strip, cprs - MAC-32 C compiler for 5620 


SYNOPSIS 
3cc [ option ] ... file ... 


ceprs infile outfile 


DESCRIPTION 
3cc is the C compiler for the MAC-32 microprocessor in the Teletype DMD-5620 terminal. Its default 
action is to compile programs to run under the mux(9.1) environment. 


The behavior of 3cc is similar to cc(1); here are listed only the capabilities peculiar to 5620s. 


The following 5620-specific options are interpreted by 3cc. 


-J Compile the named programs, and link them for running stand-alone on a 5620 terminal. 
—m Compile the named programs for ordinary (non-jerq) environments. 

-O Invoke an object-code improver (not recommended). 

—Dname=def 


-Dname Define the name to the preprocessor, as if by ‘#define’. If no definition is given, the name is 
defined as "1". The symbol MUX is predefined unless —J or -m is set. 


-Idir  ‘#include’ files whose names do not begin with ‘/ are always sought first in the directory of the 
file argument, then in directories named in -I options, then in directories on a standard list, which 
includes /usr/jerq/include . 


Associated object-code manipulating programs exist, with specifications identical to the usual Unix pro- 
grams with names prefixed *3’. The loader, assembler and archive program are System V derivatives, and 
are slightly different in behavior; see the System V manuals. For typical users, these differences are irrele- 
vant. The support programs include: 


3as assembler, see as(1) 

3ar archive, see ar(1) (there is no 3ranlib) 

3nm name list, see nm(1); doesn’t work on archives 

3size object code size, see size(1) 

3strip symbol table, see strip(1). (-r is mandatory for mux-runnable binaries.) 


3strip has no -g flag; but cprs removes redundant symbol table entries while copying infile to outfile. 


FILES 
a.out loaded output 
/tmp/ctm? temporary 
/ib/cpp preprocessor 
/asr/jerq/lib/m32/comp compiler 
/asr/jerq/lib/m32/optim optimizer 
/asr/jerq/lib/*.o runtime startoff, etc. 
/ust/jerq/lib/libc.a standard library 
/usr/jerq/lib/libj.a stand-alone graphics library 
/usr/jerq/lib/libmj.a mux-runnable graphics library (default) 
/usr/jerq/lib/muxmap __ loader I-file 
/usr/jerq/include standard directory for ‘#include’ files 
SEE ALSO 


System V manuals for 3ar, 3ld, 3as and cprs documentation. 
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BLITBLT (9.1) 


Eighth Edition BLITBLT (9.1) 


NAME 

blitblt - make hard copy of screen image 
SYNOPSIS 

blitblt [-—p command } 
DESCRIPTION 


FILES 


BUGS 
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Blitbit copies part or all of a jerq screen into a file or down a pipe to a printer daemon. The program is 
menu driven off button 3 as follows: 


choose layer 


layer interior 


flip border 


reverse video 
run/halt 


sweep rectangle 
whole screen 


write file 


| command 


exit 


A bull’s eye cursor appears. Clicking button 3 with the cursor inside a layer (cf. 
3pi(9.1)) selects it for subsequent manipulation. 


As above, but the border surrounding the layer is not included. 


The border is changed from narrow to wide (or vice versa) in the selected layer or rect- 
angle. 


The video is inverted in the selected layer or rectangle. 


The terminal process in the selected layer is continued or halted. This menu entry 
changes with the layer’s status. 


A rectangle cursor appears. The rectangle swept out on button 3 becomes the selected 
area. 


The entire screen, including border areas, but excluding the blitbit layer itself, is 
selected. 


The portion of the screen previously selected and prepared is written into a file or pipe. 
The filename is typed in answer to a prompt appearing at the bottom of the b/itbit layer. 
Hitting return selects the (default) name in parentheses. If the first character typed is a 
le (pipe symbol), the remainder of the line is taken as a shell command which will read 
the bitmap on its standard input. 


The selected portion of the screen is sent to the command specified by the —p option 
(default bcan.) 


Must be confirmed by clicking button 3 in response to the skull cursor. 


/ust/jerq/mbin/blitblt.m — terminal program 


SEE ALSO 


can(1), bitfile(9.5) 


Moving layers (e.g. clocks) result in broken images. Use the halt function. 
If a pipe request fails, the blitbit layer becomes unusable. 


BLITMAP (9.1) Eighth Edition (seki) BLITMAP(9.1) 


NAME 


blitmap — map plots and path finding on a jerq 


SYNOPSIS 


blitmap [ options ] 


DESCRIPTION 
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Blitmap displays maps on the jerq terminal. It relies on the mouse to select regions, functions, and to give 
formats for typed commands. The metropolitan N.Y.-N.J. area is the default map. Blitmap’s screen con- 
sists of two frames, a large frame for plotting maps and printing messages to the user, and a one-line com- 
mand frame at the bottom. Blitmap recognizes two commands from the keyboard, to designate a region and 
to scale or plot a route from one point to another. A command may be typed at any time. 


Button 3 389173.sp48u 

Regions 
Select which region to plot. Available regions are San Francisco, New York City and North Jer- 
sey, Washington, Los Angeles and Ann Arbor. 

Zoom-in 
Using button 3 and the box icon, enclose the area desired and blitmap will plot a map of that area 
centered at the center of the drawn rectangle. 

Zoom-out 
Enclose an area with a rectangle and the map shown will be reduced to the rectangle size and the 
rest of the map filled in. The center will be at the center of the drawn rectangle. 

Center With button 3 point to new center. The radius will remain the same. 


Prev. map 
Blitmap plots the previous frame. 


To draw map 
Gives the format of the command the user types to plot a map. 


To find path 
Gives the format of the command the user types to find a path. 


Quit Must be confirmed 


Button 2 
Button 2 controls map editing functions. No editing is actually done, but by using the -f option, a file of 
changes will be written, which may be added to the actual database. 


Keyboard 


[-options ...] radius address[,town or zip] 
Blitmap plots an area with the given radius in miles around the address. 


path [-options ...] from address to address[,town or zip] 
A route is outlined on a map and printed directions are given from point to point. 


Address may be a number and street or an intersection such as, ‘main and 10th’ or ‘600 Mountain av,new 
providence.’ The options specify the algorithm of the path search and plotting choices. The plotting 
options may be used with both commands. 


Path finding options 

—2 Two ended search (default). 

-1 One way search. 

-b Breadth search. 

-C Cyclists — ignore costs for turns. 

—-F Stop at first route connect with breadth search. 

-H Hierarchical search.(Give priority to database with major roads.) 


BLITMAP (9.1) 


FILES 


BUGS 


Eighth Edition (seki) BLITMAP(9.1) 


-G In breadth search, ignore ones whose cost + dist >4/3 total airline distance. 
-J Use precomputed routes. (Available from 600 mountain av,New Providence.) 
-V Verbose directions (all intersections given). 

-W Walkers — no cost for turns and ignore one-way streets. 

Plotting options 

-A Print every possible label. 

-B Print business names. 

-MIx = Forces a detailed street plot for maps whose radius is greater than 10,000 ft. 
—-b Don’t print boundaries. 

-ix Plot only streets with importance >x; x=0 is default. 

-j Do sketch map only. 

-l Don’t print labels. 

-r Don’t print railroads. 

-s Don’t print streets. 

-w Don’t print waterways. 


/n/seki/ust/rje/BLIT/term/term — terminal support program 
/n/seki/m?/map/* map files 


Since the data bases have not been checked and many streets are not connected, some paths may be cir- 
cuitous. There are no connecting roads from N.J into N.Y or from Middlesex county into Union. The rout- 
ing programs will churn, trying to find a through street and will not give up. There are no one-way street 
tags on the streets. Blitmap does not know if it has been reshaped. 
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C56(9.1) Eighth Edition C56(9.1) 


NAME 
c56 — terminal program with data compression 

SYNOPSIS 
c56 

DESCRIPTION 
C56 replaces the program in the layer on its standard output with an emulator for a Teletype DMD 5620 
stand-alone terminal. In the resulting layer, environment variable TERM is set appropriately. The charac- 
ter stream from the host to the terminal is compressed using an adaptive algorithm that often doubles the 
effective data rate of a slow host-terminal connection. 
This terminal program is most useful at speeds of 2400 baud and below. At 9600 baud, the terminal cannot 
generate characters and put them on the screen fast enough to keep up, and the extra overhead introduced 
by decompression just slows things down. 

BUGS 


Unexported shell parameters and functions are lost. 
Race conditions occasionally leave the tty modes set improperly at start-up. 
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CIP (9.1) Eighth Edition CIP(9.1) 


NAME 
cip — picture drawing program 


SYNOPSIS 
cip 

DESCRIPTION 
Cip is an interactive drawing program that writes pic(1) input files. It provides a pallette of pic shapes 
(box, circle, ellipse, line, arc, spline, and text) for drawing and editing pictures on a screen. There is a 
macro facility for treating a collection of drawn shapes as a single entity. The mouse provides positional 
information. The buttons invoke drawing, editing, and command functions. The keyboard is used only for 
typing in text strings and filenames. The pictures are saved as pic descriptions, and can be included with 
text, tables, and equations as input to troff. Existing pic descriptions of pictures can be displayed and edited 
as well. 


Cip relies on the host machine only for file transfers. If the host crashes while you are creating or modify- 
ing a picture, there is no way to save the picture. 


FILES 
/usr/jerq/mbin/cip.m — terminal program 
SEE ALSO 


pic(1), ped(9.1) 
Sally A. Browning, Cip User’s Manual: One Picture is Worth a Thousand Words. 
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FACE(9.1) Eighth Edition FACE(9.1) 


NAME 
face — show faces on jerq 


SYNOPSIS 
face machine!user file ... 


DESCRIPTION 
Face displays the 48x48 bit icons specified by its arguments. If an argument contains an exclamation mark, 
it is assumed to be a machine and user pair and is looked up in the face file system (see faced(9.5)); other- 
wise it is taken to be a file name. If the file does not exist and contains no slashes, it is looked up in 
/n/face/48x48x1. 


When face’s layer is full, it waits for a character to be typed before continuing. 


SEE ALSO 
faced(9.5), icon(9.1), vismon(9.1) 
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ICON (9.1) Eighth Edition ICON (9.1) 


NAME 


icon — icon editor 


SYNOPSIS 


icon 


DESCRIPTION 


Icon is a pixel-level editor for textures and small bitmaps. Jcon’s layer has in the lower right a magnified 
grid, where each square represents a pixel, and in the upper left the image in real size. Editing is done on 
the magnified grid. Pixels can be turned black by pressing the left mouse button, and can be turned white 
by pressing the middle button. Many of the command icons require a rectangle to be swept; this is done 
either by the middle button (which supplies a fixed 16x16 rectangle) or by the right button (for rectangles 
of any size). 


arrow Move region (sweep rectangle and click at destination). 


overlapping regions 
Copy region (sweep rectangle and click at destination). 


cross Invert region (sweep rectangle). 
eraser Erase region (sweep rectangle). 


horizontal (vertical) folded arrow 
Reflect region horizontally (vertically) (sweep rectangle). 


deasil (withershins) arrow 
Rotate region deasil (withershins) (sweep rectangle). 


horizontal (vertical) sheared lines 
Shear a region horizontally (vertically) (sweep rectangle and point at destination of near- 
est corner of rectangle). 


scaled square Scale a region (sweep rectangle and sweep destination rectangle). 


tweed pattern Texture a region (sweep source rectangle and a (bigger) destination rectangle to be tiled 
with copies of the source). 


glasses Read file (type file name and position the icon by clicking). The subdirectories of 
/usr/jerq/icon/ are searched automatically after the current directory. 


grid Switch on or off the background grids. 
extend region Change the size of the drawing area. 
pen Write file (sweep rectangle and type file name). See bitfile(9.5) for the format. 


overlapping rectangles 
Bitblt region (driven by submenus on the right button). 


mouse Pick up a 16X16 rectangle and make it the current cursor (click a button to pick up a 
16x16 region, and click again to revert to normal). 
help Display help information (click a button to revert to normal). 
band-aid Undo last drawing operation. 
FILES 
/usr/jerq/mbin/icon.m — terminal program 
SEE ALSO 
bitfile(9.5) 
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jf — font editor 


SYNOPSIS 


jf [ file]... 


DESCRIPTION 


FILES 


Jf edits jerq font files. If file does not begin with a slash and is not a font file, it is looked up in a standard 
font directory. 


Jf is mostly mouse- and menu-driven, except when prompting for file names. Jf divides its layer into two 
types of areas: The font displays show all characters in a given font in actual size; when characters are 
opened for editing, they appear magnified in edit displays. 


Button 1 

is the ‘do it’ button. Clicking button 1 inside a font display opens a character for editing; inside an edit 
display it sets a pixel. It may have other functions selected via menus, in which case the function is indi- 
cated by a special cursor. 


Button 2 
is the ‘undo it’ button. Clicking button 2 closes a character or clears a pixel, unless conditioned otherwise 
via menu selection. 


Button 3 

is the ‘menu’ button. Clicking button 3 selects a menu, pops control back to the top level, or (when the 
gunsight cursor shows) picks a font or character to be affected. Sometimes menu selection is the only 
(non-trivial) option available, as indicated by a ‘menu’ cursor. 


A font is described by several parameters; these are either read from the font file, or set by default by the 
make new font function: max width (default 16 pixels), height (16)—measured from the top, ascent (16)—the 
distance of the printing baseline from the top, and range (1)-the highest-numbered character in the font. 
(The first character is numbered 0.) All may be changed under the set sizes menu. Squeeze font, in the 
open/close font menu, reduces max width as much as possible. 


Each character has a width, which is shown by the length of the baseline in the edit display. Char width 
may be set under the set sizes menu; button | sets it to 0, button 2 sets it to a specified pixel within the max 
width. Char left may be used for kerning; if made positive, it shifts a character right and causes max width 
to increase if necessary; if negative, the character will be shifted left. Otherwise char left is irrelevant to 
font editing. 


The bit function menu controls copying among characters in any of the bitbit(9.3) Codes, F_ STORE, 
F_CLR, F_OR, or F_XOR. Press button 3 on the source character; hold it down while moving and release 
it on the destination. 


Several fonts may be open at once. When editing a font, it is often convenient to open a second copy for 
recovering botched characters. 


/usr/jerq/font/* jerq fonts 
/usr/jerq/include/font.h —_jerq font header file 


DIAGNOSTICS 


The most common problem is running out of memory or screen area, in which case the offending operation 
is simply ignored. A small number of self-explanatory messages deal with errors on file I/O. 


SEE ALSO 
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NAME 

jim, jim.recover — text editor 
SYNOPSIS 

jim [ files ] 

jim.recover [ -f ] [ -t ] [ files ] 
DESCRIPTION 
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Jim is the text editor for the jerq terminal. It relies on the mouse to select text and commands. It runs only 
under mux(9.1). Jim’s screen consists of a number of frames, a one-line command and diagnostic frame at 
the bottom and zero or more larger file frames above it. Except where indicated, these frames behave iden- 
tically. One of the frames is always the current frame, to which typing and editing commands refer, and 
one of the file frames is the working frame, to which file commands such as pattern searching and IO refer. 


A frame has at any time a selected region of text, indicated by reverse video highlighting. The selected 
region may be a null string between two characters, indicated by a narrow vertical bar between the charac- 
ters. The editor has a single save buffer containing an arbitrary string. The editing commands invoke trans- 
formers between the selected region and the save buffer. 


The mouse buttons are used for the most common operations. Button 1 (left) is used for selection. Click- 
ing button | in a frame which is not the current frame makes the indicated frame current. Clicking button | 
in the current frame selects the null string closest to the mouse cursor. Making the same null selection 
twice (‘double clicking’) selects (in decreasing precedence) the bracketed or quoted string, word or line 
enclosing the selection. By pushing and holding button 1, an arbitrary contiguous visible string may be 
selected. Button 2 provides a small menu of text manipulation functions, described below. Button 3 pro- 
vides control for inter-frame operations. 


The button 2 menu entries are: 


cut Copy the selected text to the save buffer and delete it from the frame. If the selected text is 
null, the save buffer is unaffected. 

paste Replace the selected text by the contents of the save buffer. 

snarf Copy the selected text to the save buffer. If the selected text is null, the save buffer is unaf- 
fected. 

look Search forward for the next occurrence of the selected text or, if the selection is null, to the 


next occurrence of the text in the save buffer. 
<mux> Exchange save buffers with mux. 


Also stored on the button 2 menu are the last Unix command and last search string typed (see below); these 
may be selected to repeat the action. 


Typing replaces the selected text with the typed text. If the selected text is not null, the first character typed 
forces an implicit cut. Control characters are discarded, but BS (control H), ETB (control W) and ESC 
have special meanings. BS is the usual backspace character, which erases the character before the selected 
text (which is a null string when it takes effect). ETB erases back to the word boundary preceding the 
selected text. There is no line kill character. ESC selects the text typed since the last button hit or ESC. If 
an ESC is typed immediately after a button hit or ESC, it is identical to a cut. ESC and paste provide the 
functionality for a simple undo feature. 


The button 3 menu entries are: 
new Create a new frame, much as in mux. 


reshape 
Change the shape of the indicated frame, as in mux. The frame is indicated by a button 3 hit after 
the selection. 


close —_ Close the indicated frame and its associated file. 
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write Write the indicated frame’s contents to its associated file. 


The rest of the menu is a list of file names available for editing. To work in a different file, select the file 
from the menu. If the file is not open on the screen, the cursor will switch to an outline box to prompt for a 
rectangle to be swept out with button 3, as in the New operator of mux. (Unlike mux, there is a shorthand: 
sweeping the empty rectangle creates the largest possible rectangle.) The file is not read until its frame is 
first opened. If the file is already open, it will simply be made the workframe and current frame (for typ- 
ing). The format of the lines in the menu is 


- possibly an apostrophe, indicating that the file has been modified since last written, 
- possibly a period or asterisk, indicating the file is open (asterisk) or the workframe (period), 
~ a blank, 


- and the file name. The file name may be abbreviated by compacting path components to keep the 
menu manageable, but the last component will always be complete. 


The work frame has a scroll bar — a black vertical bar down the left edge. A small tick in the bar indicates 
the relative position of the frame within the file. Pointing to the scroll bar and clicking a button controls 
scrolling operations in the file: 


button 1 Move the line at the top of the screen to the y position of the mouse. 
button 2 Move to the absolute position in the file indicated by the y position of the mouse. 
button 3 Move the line at the y position of the mouse to the top of the screen. 


The bottom line frame is used for a few typed commands, modeled on ed(1), which operate on the work 
frame. When a carriage return is typed in the bottom line, the line is interpreted as a command. The bot- 
tom line scrolls, but only when the first character of the next line is typed. Thus, typically, after some mes- 
sage appears in the bottom line, a command need only be typed; the previous contents of the line will be 
automatically cleared. The commands available are: 


efile Edit the named file, or use the current file name if none specified. Note that each file frame has an 
associated file name. 


f file Set the name of the file associated with the work frame, if one is specified, and display the result. 


g files Enter the named files into the filename menu, without duplication, and set the work frame to one of 
the named files. If the new work frame’s file is not open, the user is prompted to create its frame. 
The arguments to are passed through echo(1) for shell metacharacter interpretation. 


w file Write the named file, or use the current file name if none specified. The special command w” 
writes all modified files with file names. 


q Quit the editor. 
= Print the line number of the beginning of the selected text. 


/ Search forward for the string matching the regular expression after the slash. If found, the match- 
ing text is selected. The regular expressions are exactly as in egrep(1), with two additions: the 
character ‘@’ matches any character, including newline, and the sequence ‘\n’ specifies a newline, 
even in character classes. The negation of a character class does not match a newline. An empty 
regular expression (slash-newline) repeats the last regular expression. 


? Search backwards for the expression after the query. 
94 Select the text of line 94, as in ed. 
cd Set the working directory, as in the shell. There is no CDPATH search. 


>Unix-command 
Send the selected text to the standard input of Unix-command. 


<Unix-command 
Replace the selected text by the standard output of Unix-command. 
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FILES 


BUGS 
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| Unix-command 
Replace the selected text by the standard output of Unix-command, given the original selected text 
as standard input. 


If any of <, > or | is preceded by an asterisk *, the command is applied to the entire file, instead of just the 
selected text. If the command for < or | exits with non-zero status, the original text is not deleted; other- 
wise, the new text is selected. Finally, the standard error output of the command, which is merged with the 
standard output for >, is saved in the file SHOME/jim.err. If the file is non-empty when the command com- 
pletes, the first line is displayed in the diagnostic frame. Therefore the command ‘>pwd’ will report jim’s 
current directory. 


Attempts to quit with modified files, or edit a new file in a modified frame, are rejected. A second ‘q’ or ‘e’ 
command will succeed. The ‘Q’ or ‘E’ commands ignore modifications and work immediately. Some con- 
sistency checks are performed for the ‘w’ command. Jim will reject write requests which it considers dan- 
gerous (such as writes which would change a file modified since read it into its memory). A second ‘w’ 
will always write the file. 


If jim receives a hangup signal, it writes a file $HOME/jim.recover, which is a shell command file that, 
when executed, will retrieve the files that were modified when jim exited. The -t option prints a table of 
contents, but does not unpack the files. By default, jim.recover is interactive; the -f option suppresses the 
interaction. If no files are named to jim.recover, it will recover all the saved files. 


/asr/jerq/mbin/jim.m terminal support program 
$HOME/jim.err saved diagnostic output from Unix commands 


The regular expression matcher is non-deterministic (unlike egrep), and may be slow for spectacular 
expressions. 

When reshaped, the open frames must be re-opened manually. 

The < and | operators should snarf the original text. 
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NAME 
jx —jerq execution and stdio interpreter 


SYNOPSIS 
jx file [ arguments ] 

DESCRIPTION 
Jx downloads the program in file to the jerq or layer on its controlling tty and runs it there, simulating stan- 
dard I/O functions of stdio(3). Jx works either stand-alone or in a layer. 


Stdout and stderr, if directed to the controlling terminal, will be squirreled away during execution to be 
cat’ed after the terminal program has been rebooted. 


Programs to be run by jx should include <jergio.h> and call exit() upon termination in order to restart the 
default terminal program. Programs to be run stand-alone should be compiled with the —J option of 
3cc(9.1). No special options are required for running in a layer. 


Stdio functions available under jx are 


getc putc fopen popen printf fread 
getchar putchar freopen pclose sprintf fwrite 
fgets puts fclose fprintf 

fputs access 

fflush 


Unlike in stdio(3S), getc and putc are functions, not macros. Printf has only %d, %s, Yc, %o and %x. Fou 
prints an unsigned decimal number. %D prints an unsigned long decimal number. 


Since jx uses sendchar, sendnchars, and revchar, jx programs should avoid these, and use only the stan- 
dard I/O routines. 


FILES 
/usr/jerq/include/jerqio.h 
/ust/jerq/lib/sysint standard I/O interpreter 
$HOME/.jxout saved standard output 
$HOME/ jxerr saved standard diagnostic output 
SEE ALSO 
request(9.2) 
BUGS 


Keyboard standard input doesn’t work; use kbdchar(9.2). 
Stand-alone programs do not receive arguments. 
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NAME 


lens — bitmap [magnifier 


SYNOPSIS 


: |magnifier| 


DESCRIPTION 


BUGS 
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Lens is an interactive screen bitmap magnifier. When it starts, it displays an enlarged image of a magnify- 
ing glass in its layer, which becomes a setting sun when /ens wants to confirm a command to exit. 


The first item in the button 2 menu, which rotates among go, peek and stop, determines the activity of the 
magnifier. Clicking button 1 serves as an abbreviation for selecting go or peek. When the magnifier is 
going, a crawling-bordered rectangle is drawn around the source, and the Jens window contains the 
magnified image. The mouse controls the position of the source rectangle. 


During peeking, the rectangle last selected while going is re-examined periodically, and the contents are 
magnified, whether or not the Jens window is currently selected. 


When stopped, the /ens window is inactive. 


The button 2 menu also allows changing the magnification factor. The magnification factors are chosen 
from the Fibonacci numbers, and menu items for the next size smaller and larger are presented as, e.g., 3x 
or Sx. The current magnification factor is not displayed in the menu, only the next factors larger and 
smaller. The initial magnification factor is two. 


Button 2 may also be used to select the intervals at which peeking updates occur. These intervals are 
selected, in ticks, from among the powers of two, where a tick is one-sixtieth of a second. These choices 
are presented as, e.g., 32 ticks or 128 ticks. The initial interval between peeks is 64 ticks, approximately one 
second. 


The image window may be controlled by the button 2 menu item which toggles between inset and full size. 
In inset mode, the image is displayed inside the image window of the magnified lens icon. In full size 
mode, the image is displayed in the entire Jens window. 


The final buton 2 menu entry is exit. A setting sun is displayed, and button 3 must be clicked to confirm. 


While going, the display is only refreshed when the mouse is moved. Inconsistent results may be obtained 
when Jens is used to examine its own image window. 


While peeking, it is assumed that the Jens window contains an accurate magnification of what was on the 
screen at the time of the last magnification. If Jens is used to examine its own image, strange things may 
occur. 


Due to the bitmap reshaping techniques employed by the magnification algorithms, high magnification fac- 
tors will not work with large image windows. Precisely, if the product of the vertical magnification factor 
and the width of the destination rectangle overflows a signed short integer, predictable but undesirable 
results will occur. 
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NAME 


mugs — convert gray-scale pictures into icons 


SYNOPSIS 


mugs picture ... 


DESCRIPTION 


FILES 


BUGS 
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Mugs is an interactive program for converting gray-scale images (usually scanned-in photographs) into the 
48x48 icons used by vismon(9.1) and other programs. After digesting the first picture file, mugs will dis- 
play an approximation to the original picture, a vertical slider-bar and a 48x48 icon. Hitting button | in the 
slider-bar and sliding vertically adjusts the low and high points of values of the 48x48 image. Button 2 
adjusts the low and high values simultaneously (i.e. it changes the brightness without disturbing the con- 
trast.) Button 3 presents a menu with entries: 


window 
Select a square window in the original picture using button 3. Touch down at the center of the 
square and slide around to adjust its size. 


save Type in the name of a file in which to save the currently displayed 48x48 icon. 
next Move on to the next picture mentioned on the command line. 


exit Confirm with button 3. 


/usr/jerq/mbin/mugsterm.m terminal program 


The format of mugs’s input files is largely undocumented. Among other things, it will accept files contain- 
ing an array of one-byte pixels of dimensions 480x512, 486x512, 488x512, 496x512, 497x512, 512x512, 
2047x2048 or 2048x2048. 
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NAME 


mux, ismux, invert — layer multiplexer for jerq 


SYNOPSIS 


mux [ -l commands |] 
mux exit 

mux cd directory 
ismux [ — ] 


invert 


DESCRIPTION 
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Mux manages asynchronous windows, or layers, on the jerq terminal. Upon invocation, it loads the jerq 
with a program (default /usr/jerq/lib/muxterm, settable by the environment variable MUXTERM) that is the 
primary user interface. Option —I also creates a layer and invokes the shell to run commands in it. (See 
windows (9.1)). 


The command ‘mux exit’ leaves mux, destroying all layers; ‘mux cd’ changes the directory of mux, and 
hence of layers later created, but not of the current layers. 


Each layer is essentially a separate terminal. Characters typed into the layer are sent to the standard input 
of a Unix process bound to the layer, and characters written on the standard output of that process appear in 
the layer. When a layer is created, a separate shell (the value of the SHELL environment variable, or sh by 
default) is established, and bound to the layer. 


Layers are created, deleted, and rearranged using the mouse. Depressing mouse button 3 activates a menu 
of layer operations. Releasing button 3 then selects an operation. At this point, a gunsight cursor indicates 
that an operation is pending. Hitting button 3 again activates the operation on the layer pointed to by the 
cursor. The New operation, to create a layer, requires a rectangle to be swept out, across any diagonal, 
while button 3 is depressed. A box outline cursor indicates that a rectangle is to be created. The Reshape 
operation, to change the size and location of a layer on the screen, requires first that a layer be indicated 
(gunsight cursor) and a new rectangle be swept out (box cursor). The other operations are self-explanatory. 


In a non-current layer, button | is a shorthand for Current and Top, which pulls a layer to the front of the 
screen and makes it the current layer for keyboard and mouse input. Non-current layers are indicated by a 
light border. 


There is a point in each layer, called the “Unix point’, where the next character from Unix will be inserted. 
The Unix point advances whenever characters are received from Unix, but not when echoing typed charac- 
ters. When a newline is typed after the Unix point, characters between the Unix point and the newline, 
inclusive, are sent to Unix and the Unix point advanced to after the newline. This means that shell prompts 
and other output will be inserted before characters that have been typed ahead. No other characters are sent 
to Unix (but see the discussion of raw mode below). Therefore partially typed lines or text anywhere 
before the Unix point may be edited. 


The default terminal program allows any text on the screen to be edited, much as in jim(9.1). Text may be 
selected by sweeping it with button | depressed. Typed characters replace selected text. 


All layers share a common ‘snarf buffer’ (distinct from jim’s). The cut operation on button 2 deletes 
selected text and puts it in the buffer; snarf copies selected text to the buffer; paste replaces selected text 
(which may be null) from the buffer; and send copies the snarf buffer to after the Unix point. 


Normally the terminal doesn’t scroll as text is received, but a button 2 menu item selects scrolling. A scroll 
bar indicates what portion of all the text stored for a layer is on the screen. (It measures characters, not 
lines.) Releasing button 1 in the scroll bar brings the line at the top of the screen to the cursor; releasing 
button 3 takes the line at the cursor to the top of the screen. Button 2, treating the scroll bar as a ruler, 
brings the indicated point in the whole stored text to the top of the screen. 
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The NUM LOCK key advances a half page. 


Ismux reports on its standard error whether its standard output is a mux layer, and also generates the appro- 
priate exit status. With the optional argument, no message is produced. 


Invert reverses the sense of video, from black on white to white on black, or vice versa. 


Independent user-level programs can be loaded into layers, see 32/d(9.1). SHIFT-SETUP freezes mux and 
complements the video of the layer of the running user-level terminal process. Hitting button 2 in this state 
will attempt to kill the process; 1 or 3 will leave it running. 


In raw mode or no-echo mode (see ttyld(4)) the Unix point advances with each character typed after it. 


FILES 

/usr/jerq/lib/muxterm terminal program 

/tmp/.mux* temporary file used by -I option 
SEE ALSO 


321d(9.1), jim(9.1), jx(9.1), term(9.1) 


DIAGNOSTICS 


BUGS 


Mux refuses to create a layer when there is not enough memory. Space can be recovered by deleting a 
layer. 

Error messages from mux are written directly to the layer which caused them. They are usually meaningful 
only to system administrators, and indicate system difficulties. 


Reshape only works properly for processes that arrange to see if they have been reshaped, although most 
programs make this arrangement. 
The behavior of raw mode prohibits editing partially typed lines when running cu(1). 
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NAME 


paint — draw pictures in a layer 


SYNOPSIS 


paint 


DESCRIPTION 
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Paint is a more elaborate relation of twid(9.6). 


Button 3 gets a menu. Certain menu items contain arrows, which if touched call submenus. Moving off the 
right of a submenu causes it to disappear. Pressing button 1 while holding button 3 gets a short help mes- 
sage for the menu item. The top-level menu contains: 


Style > Different kinds of brushstrokes 

Operation > Ways of putting paint on canvas 

Texture —> Things to do to the texture pattern 

Brush > Things to do to the paintbrush 

Canvas —> Things to do to the whole picture 

State > Change things saved in .paintstate 

Fill Fill an area of the picture 

Green Erase the entire picture 

Mask Display mask instead of image; “*’ means mask 
Exit Leave the paint program 


The Style submenu adjusts ‘brushstrokes’: 


Paint Multiple brushspots while holding button 1 or 2 

Circles Rubberband circles; press at center and release at circumference 
Lines Rubberband brush lines 

Curves Continuous strokes while holding button | or 2 

Line style > Solid, dotted, dashed, etc. lines 


Entries in the Line Style sub-submenu are strings of “A’s, “B’s and *.’s that describe dotted and dashed 
lines. ‘A’ stands for the brush on the button pushed, “B’ stands for the brush on the other button; ‘.’ for no 
brush at all. The string is cycled through at successive points when drawing Lines, Curves, or Circles. Thus 
‘A’ means a solid line, ‘A...’ means a | in 4 dotted line, and ‘AAAA....’ means 4-point dashes. 


The Operation submenu assigns a pair of operations, one for each of buttons 1 and 2, to be performed as the 
brush is laid down. A hidden ‘mask’ plane describes the shape that has been painted; black pixels in the 
mask are inside, green outside. Likewise, the brush consists of a pair of rectangular image and mask 
planes. There are 11 effective operations to combine the part of the brush inside its mask with the part of 
the picture it sits on (see the Porter/Duff paper for details); selected pairs can be assigned to the buttons: 


Above/Erase Button 1 paints on top, Button 2 erases 
Below/Erase Button 1 paints behind, Button 2 erases 
Above/Below Button | paints on top, Button 2 behind 
Inside/Erase Button 1 paints inside, Button 2 erases 
Brush/Clear Special effects A, CLEAR 
AoutB/AinB Special effects 

BinA/BatopA Special effects 

Xor/Above Special effects 


Above paints on top of the picture. This is the operation performed by ‘normal’ paint programs. 
Below paints underneath; it will show through only in places that were not previously covered. 
Inside paints on top, but only inside the already-painted part. 


The other 7 operations are best described as ‘special effects’. Try them out to see what they do, or look at 
the Porter/Duff paper. 
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Texture facilities paint with a repeating 16x16 pattern instead of copies of a brush. The Texture menu con- 
tains: 


Texture Turn texturing on or off; ‘*’ means on 
Make Pick a texture from the picture 

Negate Reverse the texture’s green and black 
Save Name a texture and copy it into a file 
Library —- List and and retrieve textures in library 
Get Type a name and get a texture from a file 


Make gives a 16X16 square cursor with which to pick a texture. 


The Brush submenu contains Make, Negate, Save, Library, and Get, which do for brushes what the same 
items do for textures. 


Make allows you to sweep out a region to use as a brush. 
The Canvas submenu also contains Negate, Save, Library, and Get, in this case pertaining to entire pictures. 
Library pictures are saved in a file containing the image plane then the mask plane in bitfile (9.5) format. 


The file .paintstate in the current directory remembers across invocations of paint the names of the current 
brush, texture, and libraries. The State submenu displays the library names at the bottom of the layer, 
where they can be edited: 


Brushes Name the brush directory 
Pictures Name the picture directory 
Textures Name the texture directory 


The Fill menu item gives an arrowhead cursor. If you touch down at a point not painted, the rookwise- 
connected region containing it will fill with black. On completion, the black will be replaced by the current 
texture. While the region is filling, any button click aborts the operation. 


The current selections from the Brush, Library, Style, Operation, Texture, and Line Style menus are 
marked with a ‘*’, and are displayed in the information box at the bottom of the layer. 


FILES 

/usr/jerq/paint/brush the default brush library 

/usr/jerq/paint/tex the default texture library 

.paintstate state of terminated program 
SEE ALSO 

can(1), bitfile(9.5), twid(9.6) 

Thomas Porter and Tom Duff, ‘Compositing Digital Images,’ Siggraph ’84 Proceedings 
BUGS 


The menu entries should be in lower case. 
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NAME 


ped, tped — picture editor 


SYNOPSIS 


ped [ -f ] [ file ] ... 
tped [ option]... [ file]... 


DESCRIPTION 
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Ped is an interactive drawing program for jerq terminals. A file argument is equivalent to an “e’ command 
as described below. Most features of ped are menu-controlled and self-explanatory; further details are in 
the reference. 


Button | is used to select actions from a permanent menu and to draw or pick up an object. Button 3 is 
used to terminate drawing actions and to change the permanent menu. Button 2 causes the permanent menu 
to revert to ‘basic’. 


The operation of ped is split between host and terminal. When a file is first read, it is kept on the host; 
‘bring in’ gets it to the 5620. 


Option -f causes ped to display all text in one size to save time and space. 


Permanent menus selected by button 3 follow. Actions marked ‘(t)’ in the menu toggle on and off. The last 
action is usually remembered and may be executed repeatedly until another is selected. Thus, for example, 
one can fill many polygons with one button click per polygon. 


Basic is the initial menu. ‘blitblt’, like blitb/t(9.1), copies part of the screen to file ‘BLITBLT’, for dis- 
play on a laser printer by bcan; see can(9.1). ‘Exit’ requires a confirming push of button 3. 
‘Markers’ makes visible the defining points of objects; in circles and text, these are the only points 
sensitive to selection by button 1. 


“Type comm’ deactivates the mouse and takes input from the keyboard. The keyboard commands 
follow. The first four behave like similarly named commands in ed(1), using a remembered name 
when none is given. 


ef edit a new picture from file f; remember its name. 

ff Change the remembered name to f and report the new remembered name. 
rf Read file f into ped. 

wf Write the current picture onto file f 


u string Use string as a shell command to be applied when the menu selection user oper is made 
later. The string is remembered. 

edd Change working directory to d; like cd in sh(1). 

pwd Print working directory; like pwd(1). 


<newline> 
m Reactivate mouse. 
qq Quit; same as ‘exit’ in basic menu. 


If ‘e’ or ‘qq’ happens when the picture has been changed since the last ‘w’, the picture is saved in 
file ‘ped.save’. 


Ch size includes changes in object size, rotations, etc. ‘Rotate’ displays a vector from a center of an object 
to the designated point. Then the object is rotated and scaled to bring that point to a second desig- 
nated position. “H-elong’ and ‘V-elong’ change aspect ratios; they are inverses. 


Move includes ‘move’, and ‘copy’ commands for objects. Button 3 cancels a move or copy. To help 
untangle overlapping objects, the cancellation of a move does not take place until returning to the 
basic menu. ‘Attach’ moves an open polygon (a broken line) and hooks it to the end of another. 
‘Join’ connects the ends of two polygons. ‘Link’ causes multiple polygons to move as one and to 
be filled as one (useful for making holes). Mutually linked polygons must all be open or all be 
closed. ‘Match’ moves objects to bring designated points together; ‘center’ brings the centers of 
their bounding boxes together. 


PED (9.1) Eighth Edition PED(9.1) 


Draw creates objects. Button | fixes a point; button 3 terminates an object. ‘Text’ objects may occupy 
several lines; an empty line terminates text. ‘Grid’ causes points to snap to locations on a grid, 
which indexes through settings FMC (fine, medium, coarse). ‘Fix sz’ sets option —f. ‘Family’ 
designates objects to be moved or deleted together. A family is defined by drawing a box around 
it in the draw menu or by pointing to its members in the move menu. 


Reshape 
for editing objects. ‘Formal’ adjusts nearly vertical or horizontal lines in an object to be truly ver- 
tical or horizontal. ‘Spline’ produces a curve guided by a polygon. ‘Corner’ toggles a point of a 
spline to be multiple — a corner in an otherwise smooth curve. 


Refine has additional editing commands. ‘Adj t’, with settings LRC, causes text items to be left-justified, 
centered, or right-justified on a point. “Edit text’ displays text at the top, where button 1 selects a 
character position for inserting by typing or deleting by backspacing. Button 3 concludes the edit- 
ing. ‘User oper’ applies a user-specified command to the selected object. 


Shade provides textures for filling polygons, circles, or spline-bounded regions. Curves are filled 
schematically on the 5620, but accurately on the host. 


Color _ has no effect on the jerq, but is carried through for display on other devices. 
Remote performs all editing on the host using the jerq as a display device only. 


Tped is a filter to convert files of graphic information produced by ped into typesetting requests for troff(1). 
The options are: 


-Tdev Prepare output for particular devices known to troff: -Taps or -T202. 
-b Place a box around each picture. 


The input may be straight ped output or may be arbitrary text files with ped output embedded between pairs 
of delimiting lines: 


.GS [ size ] 
ped file 
.GE 


The optional size specification gives width or height in the form w=inches or h=inches. The ped text may 
be in another file: 


.GS [ size ] pedfilename 


SEE ALSO 
T. Pavlidis, PED Users Manual, AT&T Bell Laboratories Computing Science Technical Report No. 110, 
March 1984 
blitblt(9.1), can(1), pic(1), ideal(1), troff(1), doctype(1) 


DIAGNOSTICS 
Ped error messages from the host are placed in file ‘.pederr’. Error messages from the terminal appear on 
the screen. 


BUGS 
Pictures may spill into the menu or message areas. 
Some experimentation with tped printout parameters is needed to obtain satisfactory results. 
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NAME 


Eighth Edition PI(9.1) 


pi, 3pi — process inspector 


SYNOPSIS 


pi [ -t corefile objectfile ] 
3pi [ —-p programmer ] 


DESCRIPTION 


Pi is a C debugger that is bound dynamically to multiple subject processes or core dumps. It works better 
for programs compiled cc —g. Pi uses the Pads(9.5) multi-window user interface. There are three types of 
windows: debugger control windows, which access the global state of the debugger; process control win- 
dows (exactly one per process), which start and stop processes and connect to process-specific functions; 
and process inspection windows, which include viewers for source text and memory, formatted various 
ways. 


The most important debugger control window is the pi window itself. Each line within the pi window 
refers to a specific process. These lines may be introduced to the window by running ps(1) from the button 
3 menu; by typing a file name, either a /proc(4) name, or the name of a core image followed by the name of 
the binary that created the core; or by typing a command, prefixed by an exclamation ‘!’, to be executed as 
a child of pi. There are several ways to access a process (using the button 2 menu), each of which gener- 
ates a process control window: open process (open coredump) attaches to a running process (core image); 
open child attaches to a process forked by a process being debugged by the current pi; and take over 
rebinds an existing process window hierarchy (pointed to with the mouse) to the named process, which 
must be an instance of the same program. A command may be instantiated afresh (hang & open proc) or 
restarted and bound to an existing process window (hang & take over); in either case, IO is redirected to 
/dev/null. 


The process window indicates the process’s state, shows the call stack traceback and connects to windows 
that access source text, local variables within a stack frame, raw memory, and so on. These windows are 
cross-connected, so, for example, an instruction in a process’s assembly language window can be inspected 
in hexadecimal in the raw memory window. Closing the process control window closes all the windows 
under it. 


The following menu functions are provided by the various window types in pi. Initially there are these 
windows available: 


Help Reminder of user interface mechanics. 


Pi Overall control of processes, core dumps and programs. A process is identified by its pathname or 
command line. Process symbols are found in the executable file from which the process was 
loaded, but may be overridden. Symbols for core dumps must be supplied explicitly, after the core 
filename. Synopsis: Identify and open process or core dump; run a program as Pi’s child; take 
over a process with the debugging environment of a different one. 


Pwd/cd change the working directory of the debugger. 


Process Window 
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Selecting and opening a process from the Pi window creates a new window with overall control of that pro- 
cess. It shows the process state, and a traceback if the process is halted or dead. States are: 


ACTIVE running normally 

HALTED halted asynchronously by a debugger 
BREAKPOINT halted on reaching breakpoint 

STMT STEPPED halted after executing C source statement(s) 
INSTR STEPPED halted after executing machine instruction(s) 
EVENT PENDING halted about to receive a signal being traced 
ERROR STATE the process has probably exited. 


The menu operations on the process are: 
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go let the process run 

stop stop the process 

kill send signal SIGKILL to the process 

src text open source text window(s) 

Signals open window for sending and trapping signals 

Globals open window for evaluating expression in global scope 
RawMemory _ open window for editing uninterpreted memory 
Assembler open window for disassembler 


Each line of the call stack traceback describes one function. Each function in the traceback can open an 
expression evaluator window or display its current source line. 


Globals and Stack Frame Windows 
These windows evaluate expressions with respect to global scope, and scope in a function, respectively. A 
stack frame window is opened from a line in the call stack traceback or from a line of source text. C 
expressions can be entered by the keyboard or mouse. The unary operators fabs and sizeof are supported; 
the only assignment operator is ‘=’. Functions from the user program may be called. 


New C expressions can be derived from old ones by the keyboard or mouse. In menus and the keyboard, $ 
means the expression in the current line. The VAX registers are called $r0 to $r15; the address of a register 
is the location at which it was saved. The format in which values are displayed can be changed. The raw 
memory editor may be entered using an expression’s value as address. An expression may be made a spy. 
The value of a spy expression is evaluated and displayed each time the debugger looks at the process. If the 
value of a spy changes the process is halted at the next instruction, statement or breakpoint. A stack frame 
can find its active source line in a source window or the stack frame window of its caller. 


The comma operator is useful in conditional breakpoints because the values of its subexpressions are dis- 
played. E.g. x, y, x==y traces the values of x and y when the condition fails; x, y, 0 just traces. 


To cross scope boundaries, the environment (a function identifier) in which an expression is to be evaluated 
may be specified as: { expr } function. From the source directory window, file static variables can be pro- 
moted to appear in the menu of global variables. 


Source Text Windows 

The source file directory window lists all the source files, if there are two or more. A textual prefix, entered 
from the keyboard, points to a source directory, without changing the working directory. Each source file is 
in a separate window, opened when needed. The source file’s pathname as given to cc can be overridden 
from the keyboard. If things go wrong, use reopen to open the file afresh. Synopsis: set/clear (condi- 
tional) breakpoint; single-step source statements; step into (rather than over) a function; go the process; 
show the statement for the current PC; open a stack frame window for a source line’s function; evaluate 
expression; disassemble first instruction of source statement; context search for string. 


Breakpoints Window 
Lists all the active source and assembler breakpoints and related errors. Synopsis: show source or assem- 
bler for a breakpoint; clear breakpoint; clear all breakpoints. 


Signals Window 
Lists all signal types, showing which ones are traced. Synopsis: Change which signals are traced; send a 
signal to the subject process; clear pending signal; stop process on exec. 


Raw Memory Window 
A ‘“‘memory editor’’ in which memory is a viewed as a sequence of 1-, 2-, 4- or 8-byte cells. Synopsis: set 
cell address; change cell size; change display format; display cells above and below; indirect to cell; change 
cell value; spy on memory cell; disassemble instruction at cell. 


(Dis)assembler Window 
Disassembler in which memory is viewed as a sequence of instructions. Synopsis: set instruction address; 
display more instructions; change display format; display instruction as cell in raw memory window; 
set/clear breakpoint on instruction; open stack frame window for instruction’s function; display instruction 
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at current PC; single step instruction(s); step over a function call instead of into the function. 


Exec and Fork 
If a process controlled by pi executes an exec(), it is suspended as if started by hang (1), if an exec() break is 
set in the Signals window. To debug the process after the exec, close the original process window and re- 
open it. When re-opened it will get the new symbol tables. 


To debug a child process: (i) set a breakpoint in code that will be executed in the child after the fork; (ii) 
execute the fork at full speed (the child inherits the parent’s breakpoints, which aren’t there if the parent is 
stepped); (iii) before altering any breakpoints, get a fresh ps in the Pi window and apply open child to the 
child. The child should be stopped on the inherited breakpoint, but it and all other breakpoints should have 
been cleared. 


Kernel 
The state of kernel variables associated with a process may be examined by giving their name or virtual 
address. The UNIX environment variable specifies the file from which the system was loaded; the default 
is /unix. Kernel dumps may be examined by opening the ‘kernel pi’ window. 


Just A Traceback 
With the -t option pi writes a traceback on its standard output and quits. 


3pi 
3pi is a variant of pi for debugging 5620 programs running under mux(9.1). It creates two terminal pro- 
cesses: one for its access to terminal memory and graphics and a second for its Pads(9.5) interface. 


Remote Debugging 
With the -p option 3pi loads its first process, but not Pads. Instead, it mails a 3pi command to 
programmer, to be executed on any host in the local network. That 3pi command loads Pads on 
programmer’s terminal, and connects to the originator’s terminal. If separate hosts are involved and the 
versions of critical files differ, be careful with pathnames. 


3pi Graphics 
Points, rectangles, textures and bitmaps can be displayed graphically. 

3pi — pi 
Most differences come from obvious differences in the hardware and software architectures. Also, in 3pi 
function calls are executed by a debugger process on its own call stack. 


SEE ALSO 
hang(1), proc(4), strip(1), pads(9.5) 


BUGS 
In switch statements there is no boundary between the last case and the branch code; the program appears 
to jump to the last case (but is really in the branch) and then to the real case. A changed spy only stops the 
process at a breakpoint or while stepping. An expression can be cast only by menu. Functions may only be 
called when the process is stopped and not in a system call. 
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NAME 


proof — troff output interpreter for jerq 


SYNOPSIS 


proof [ -ffonts ] [ file ] 


DESCRIPTION 


Proof reads troff(1) intermediate language output from file and displays a simulation of the resulting pages 
on the screen. If no file name is given and the standard input is the terminal, proof terminates immediately 
leaving a ‘proof layer’, otherwise it reads the standard input. By invoking proof in a proof layer you can 
avoid download time. 


Fonts are loaded as required. The default font is used for unknown fonts. The font option can be used to 
preload fonts. Use the names of the fonts relative to /usr/jerq/font separated by commas. The most-used 
fonts are ‘—fR.10,1.10,S.10’. 


After a layer’s worth of text is displayed, proof pauses for a command. Commands may come from the 
host, the keyboard, or the button 3 menu. The typed versions of commands are: 


<newline> 
Go on to next portion of text. (Button 3 equivalent: ‘more’.) 
Quit, leaving a proof layer. 
Exit and restart the regular terminal program. (Equivalent to ‘q’ followed by jterm(9.1).) 


pn Print page n. An out-of-bounds page number means the end nearer to that number; a missing num- 
ber means page 0; a signed number means an offset to the current page. 


Button | gets a scroll box, which represents a full page of text. An interior rectangle shows what part of the 
page is now visible. The interior rectangle moves with the mouse, causing the layer to scroll both vertically 
and horizontally. Button 2 gets a speedometer. The bar of the speedometer moves with the mouse to con- 
trol the rate at which new information is displayed. 


FILES 

/usr/jerq/font/* fonts 

/asr/jerq/font/.missing list of referenced but unconverted fonts 
SEE ALSO 

d202(1), font(7) 

‘A Typesetter-independent Troff,’ Brian W. Kernighan 
BUGS 


Page | 


There is a maximum number of fonts (currently 50) that can be loaded at once. 
Windowing can get confused if the troff ouput is not approximately sorted in ascending y-order. 
A proof layer imitates term 33(9.1), not mux(9.1). 
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NAME 
ruler — measure things on the screen 


SYNOPSIS 
ruler 


DESCRIPTION 
Ruler measures things on a jerq screen. Press button | to sweep out a rectangle anywhere on the screen. 
For each rectangle swept, ruler displays the coordinates of the rectangle’s corners (labelled ‘down’ and 
‘up’), the size of the rectangle and length of its diagonal. 


There is a menu on button 3. The pixels and chars buttons control whether the size and diagonal measure- 
ments are in pixel or 9x14 character units (the size used by jim(9./) and mux(9.1)). The stop button deacti- 
vates ruler without exiting. Hitting measure reactivates ruler. Exit exits. 


BUGS 
Ruler’s menu must pop up in its own layer, perhaps far away from the cursor. 
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NAME 


sysmon, vismon — display system statistics 


SYNOPSIS 


sysmon [-n ] [ -m ] [ system ... ] 


DESCRIPTION 


FILES 


Sysmon monitors use of one or more UNIX systems. It displays time of day, announcements, and CPU 
usage Statistics. 


CPU usage is reported as a numerical load average (average number of runnable processes) and its change 
in the last minute, and a bar graph showing, left-to-right, the proportion of CPU time spent in: default- 
priority user processes, low priority (nice) processes, system kernel, stream I/O, and idle time. 


Arrival of mail or communications via wall(1) or write(1) is announced. Communications appear in a shell 
(sh(1)) layer superimposed on sysmon’s layer. This layer may be used for reply. 


The options are: 
—n Update the bar graph every n seconds. (n=5 by default.) 
—m Do not monitor CPU usage on other systems. 


Vismon is the same as sysmon, but identifies mail sources by picture as well as by name. 


/usr/jerq/mbin/sysmon.m terminal program 
/usr/spool/mail 

/usr/spool/mail/mail.log 

/n/face/* vismon pictures 


DIAGNOSTICS 


‘Can’t open comm window’ means a shell layer cannot be created. To receive any further communications, 
delete some layer. 


SEE ALSO 


BUGS 
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face(9.1), faced(9.5) 


There’s more to system performance than meets the eye. 
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NAME 
term — nonstandard mux terminals 


SYNOPSIS 
exec term termtype 


DESCRIPTION 
Term replaces the program in the layer on its standard output with an emulator for the terminal type 
specified by termtype. In the resulting layer, environment variable TERM is set appropriately. Known 
types are 


2621 Hewlett-Packard 2621 

4014 =Tektronix 4014 

5620 Teletype DMD 5620 stand-alone terminal. 

33 Teletype Model 33 (actually closer to 35). 

Also, termtype mux restores and initializes a standard mux(9.1) terminal program. 


BUGS 
Unexported shell parameters and functions are lost. 
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NAME 


thinkblt, think — print on ThinkJet 


SYNOPSIS 


thinkblt [ stream ] 
think [ -o stream | [ files... ] 
nroff —Tthink ... | think [ -o stream | 


DESCRIPTION 


Thinkbit downloads an interrupt driver for the printer, provides a menu of operations for printing various 
data residing in the terminal, and sets up a stream ($HOME/.THINK by default) on which think can print 
data from the host. It is intended to be down-loaded once per terminal session. Most of the menu items are 
identical to those of blitbit(9.1). The remaining ones are: 


print bitmap prints whatever bitmap is currently selected, in analogy to blitbit(9.1). The widest 
printable bitmap is 640 pixels across. 


print mux buffer prints the mux ‘snarf’ buffer. 
reset printer sends ‘<esc>E’. 


While the printer is operating, a different menu allows one to abort or pause the print operation. The printer 
has a fairly large internal buffer, so response may be slow. 


Files on the host may be printed by giving them as arguments or standard input to think. When used with 
nroff, names like \’e may be used to access the special characters provided by the hardware; see the 
nroff(1) terminal driving file for a complete list. Both nroff(1) and pr(1) will paginate properly if top-of- 
form is set so that the paper tear is aligned flush with the top of the metal clip which holds the absorber. 


FILES 
/usr/jerq/mbin/thinkblt.m — terminal program 
/usr/lib/term/tab.think — nroff descriptor file 
SEE ALSO 
troff(1), pr(1), blitblt(9.1) 
BUGS 
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The 5620 ROM program is unable to cope with interrupts from the printer; it is therefore necessary to 
download mux(9.1) before powering on the printer. 


Thinkbit substitutes its own interrupt routine for the (trivial) one provided by mux(9.1). The latter is 
restored upon exit, but havoc may result if the thinkbit layer is simply deleted. 


The special nroff(1) character names are not currently supported by any other device. 
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NAME 


windows, jps, reshape — create and initialize windows 


SYNOPSIS 


windows [ ox oy cx cy "command [args]" ] ... 
Jps 
reshape [ -r] x y 


DESCRIPTION 


For each set of arguments, windows makes a mux(9.1) layer with rectangle Rect(ox, oy, cx, cy) (see 
types(9.5)), then executes the command therein. The command may be null (""). Any number of layers 
may be specified; each command and its args appears as a single argument to windows. 


In windows that are not expected to be reused and do not need a shell, it is good practice to invoke the 
command with ‘exec’; see sh(1). 


Jps prints the rectangle coordinates of each window and the arguments (if any) with which it was down- 
loaded, to help set up the windows command. 


Reshape adjusts its layer so that the display rectangle inside the border is x by y pixels. Under option -r it 
adjusts the width/height ratio to x/y, with the new shape as large as will fit inside the old. 


SEE ALSO 


mux(9.1), ruler(9.1) 


DIAGNOSTICS 


BUGS 
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Windows may adjust rectangles to a minimum size or to stay within the usual layer bounds (8 pixels inside 
the screen edge). 

Layer creation can fail if there are no process slots or memory left in the terminal. 

Reshape clips a layer that is too big (display rectangle > 786x1002) and does nothing if the layer is too 
small (<100x40) or if there is no space. 


Jps reports what has been downloaded to the 5620; usually this is not the same as the command that must 
be used in windows to cause the download. 
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NAME 


button123, mouse, cursallow, cursinhibit, cursset, cursswitch, getrect123 — mouse control 


SYNOPSIS 


#include <jerq.h> 


extern struct Mouse { 
Point xy; 
short buttons; 

} mouse; 


int button(n) int n; 
int button1(), button2(), button3(; 
int button12(), button23(), button123(); 


void cursinhibit(); 
void cursallow(); 


void cursset(p); Point p; 
Texture *cursswitch(t); Texture *t; 


Rectangle getrect(n) int n; 
Rectangle getrect1(), getrect2(), getrect3(); 
Rectangle getrect12(), getrect23(), getrect123(); 


DESCRIPTION 
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For processes that request the mouse (see request(9.2)), the mouse state is updated asynchronously in the 
per-process structure mouse. The coordinates of the mouse are held in mouse.xy, and the state of the but- 
tons in mouse.buttons. Each process’s mouse structure is independent of the others, so that (except for 
cursset) actions such as changing the tracking cursor do not affect other process’s use of the mouse. Mouse 
is not updated if the process does not ‘own’ the mouse; see request(9.2). 


The macro button and its counterparts return the state of the associated mouse button: non-zero if the button 
is depressed, 0 otherwise. The buttons are numbered | to 3 from left to right. Button]2 and the other 
multi-button functions return the OR of their states: true if either button | or button 2 is depressed (as 
opposed to button | and button 2). 


Cursinhibit turns off interrupt-time cursor tracking (the drawing of the cursor on the screen), although the 
mouse coordinates are still kept current and available. Cursallow enables interrupt-time cursor tracking. 
Cursallow and cursinhibit stack: to enable cursor tracking after two calls to cursinhibit, two calls to 
cursallow are required. 


Cursset moves the mouse cursor to the Point p. 


Cursswitch changes the mouse cursor (a 16x16 pixel image) to that specified by the Texture *f. If the argu- 
ment is (Texture *)0, the cursor is restored to the default arrow. Cursswitch returns the previous value of 
the cursor: the argument of the previous call to cursswitch. 


Getrect prompts the user with a box cursor and waits for a rectangle to be swept out named button, 
identified as with the button primitives. It returns the screen coordinates of the box swept. The box may be 
partly or wholly outside the process’s layer. 
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NAME 
newlayer, dellayer, Ibitblt, point, Irectf, lsegment, Itexture, upfront — layer control and graphics 


SYNOPSIS 
#include <jerg.h> 


Layer *newlayer(r); Rectangle r; 

void dellayer(1) Layer *1; 

void Ibitblt(sl, r, dl, p, f) Layer «sl, «dl; Rectangle r; Point p; Code f; 
void Ipoint(, p, f) Layer *1; Point p; Code f; 

void Irectf(1, r, f) Layer «1; Rectangle r; Code f; 

void segment(I, p, q, f) Layer «1; Point p, q; Code f; 

void Itexture(I, r, t, f) Layer «1; Rectangle r; Texture *t; Code f; 


DESCRIPTION 
Newlayer creates a layer in Rectangle r in the physical display bitmap, and returns its address, or 0 on fail- 
ure. Newproc(9.2) explains how to attach a process to a layer. 


Dellayer de-allocates a layer; the associated process must also be freed (see newproc(9.2)). 


The routines /bitbit, lpoint, lsegment and Itexture are equivalent to their bitbit(9.3) counterparts except that 
they never inhibit the mouse cursor, so they are mainly useful only for implementation of efficient compos- 
ite graphics operations such as circle-drawing. Because of the duality of Bitmaps and Layers, arguments of 
either type may be passed freely to any of the graphics primitives. 


SEE ALSO 
bitblt(9.3), newproc(9.2) 
Graphics in Overlapping Bitmap Layers, Rob Pike, ACM Trans. on Graphics, April 1983. 
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NAME 


P, newproc, muxnewwind, newwindow, tolayer, debug, getproc, getproctab — jerq process control 


SYNOPSIS 


#include <jerg.h> 

extern struct Proc *P; 

struct Proc *newproc(f) void (*f)0; 
struct Proc *newwindow/(f); void (*f)0; 
void tolayer(1) Layer *1; 

void debug(); 

struct Proc *getproc(); 

struct Proc «getproctabQ); 


#include <msgs.h> 
void muxnewwind(p, c) struct Proc *p; int c; 


DESCRIPTION 
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Processes in the jerq consist of a coroutine-style process structure and an associated layer (see 
newlayer(9.2)), allocated independently. This section describes the process allocation and control primi- 
tives. They are direct links to the system’s own control structures, so given mux’s open addressing, they 
should be used with care. 


Each process has a global variable P that points to its process structure. The only regular use of P is to 
check that the process has been reshaped: 


if(P—>state & RESHAPED) { 
do_reshape(); 
P— state &= “RESHAPED; 
} 


The definition of struct Proc is in the include file /usr/jerg/include/jerqproc.h, which is included automati- 
cally by jerg.h. 


Newproc allocates a new process, returning a pointer to it, or 0 if one cannot be allocated. The argument f 
points to the program text to be executed. The special case f=0 creates a process running the default termi- 
nal program, and is almost always how newproc should be called; use 32/d(9.1) to run non-standard pro- 
grams. A process is disabled by setting p—>state to zero. After calling newproc, the process must be bound 
to a layer and Unix told of its presence, typically as: 


struct Proc *p; 
Rectangle r; 


p = hewproc((struct Proc *)0); 
if(p == 0) 
error(); 
p—>layer = newlayer(r); 
if(p—>layer == 0){ 
p—>state = 0; 
error(); 
} 
p—>rect =r; 
muxnewwind(p, C_NEW); 
The second argument to muxnewwind should be C_RESHAPE if an existing process is being given a new 


layer. If the process is not running the default terminal program, its variables display and Drect must be 
set: 
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struct udata *u=((struct udata *)p—>data); 

u—>Drect=p—>rect; 

u—>Jdisplayp=p—>layer; 

This procedure works regardless of whether the process being manipulated is itself. 


Newwindow creates a process by the above procedure, going through the standard user interface to select 
the rectangle for the process’s layer. 


Tolayer takes an argument Jayer pointer and makes the process in that layer the receiver of mouse and key- 
board events. 


Getproc presents the user with a gunsight cursor and returns the address of the process whose layer is indi- 
cated with the mouse. Getproctab simply returns the address of the base of the process table array. This is 
an array of NPROC process structures. NPROC is stored in the word immediately lower in address than the 
process table. 


Debug announces to the system that the calling process is prepared to handle exceptions by other processes. 


BUGS 
These primitives are awkward at best, and are subject to change. 
Creating a process without a layer or vice versa is dangerous. 
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NAME 


request, own, wait, alarm, sleep, nap, kbdchar, rcvchar, realtime, sendchar, sendnchars, kill, exit — jerq I/O 
requests 


SYNOPSIS 


#include <jerq.h> 

void request(r) int r; 

int own(r) int r; 

int wait(r) int r; 

void alarm(t) unsigned t; 
void sleep(t) unsigned t; 
void nap(t) unsigned t; 
void realtime(); 

int kbdchar(); 

int revchar(); 

void sendchar(c) int c; 
void sendnchars(n, p) int n; char 
void kill(s) int s; 


void exit(); 


DESCRIPTION 
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Request announces a program’s intent to use I/O devices and resources, and is usually called once early ina 
program. The bit vector r indicates which resources are to be used by OR’ing together one or more of the 
elements KBD (keyboard), MOUSE, RCV (characters received by terminal from Unix), SEND (characters 
sent from terminal to Unix) and ALARM. For example, request( MOUSE | KBD) indicates that the process 
wants to use the mouse and keyboard. If the keyboard is not requested, characters typed will be sent to the 
standard input of the Unix process. If the mouse is not requested, mouse events in the process’s layer will 
be interpreted by the system rather than passed to the process. SEND and CPU (see wait below) are always 
implicitly requested. Request sleeps for one clock tick to synchronize mouse control with the kernel. 


Own returns a bit vector of which I/O resources have data available. For example, own()&KBD indicates 
whether a character is available to be read by kbdchar() (see below), ownQ)&MOUSE tells if the process’s 
mouse structure (see button(9.2)) is current, and own()&ALARM indicates whether the alarm timer has 
fired. 


Wait’s argument r is a bit vector composed as for request. Wait suspends the process, enabling others, 
until at least one of the requested resources is available. The return value is a bit vector indicating which of 
the requested resources are available — the same as own()&r. For example, if a process wants to read from 
the keyboard or the host, the following fragment illustrates how to use request and wait: 


request(KBD| RCV); 


for(;;){ 
r=wait(KBD|RCV); 
if(r&KBD) 
keyboard(kbdchar()); 
if(r&RCV) 
receive(revchar()); 
} 


Processes wishing to give up the processor to enable other processes to run may call wait(CPU); it will 
return as soon as all other active processes have had a chance to run. CPU is a fake resource which is 
always requested. The SEND pseudo-resource is unused; wait(SEND) always succeeds. 
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Alarm starts a timer which will ‘‘fire’’ ¢ ticks (60ths of a second) in the future. A pseudo-resource ALARM 
can be used to check the status of the timer with own or wait. Calling alarm implicitly requests the ALARM 
pseudo-resource. 


Nap busy loops for t ticks of the 60Hz internal clock. To avoid beating with the display, programs drawing 
rapidly changing scenes should nap for two ticks between updates, to synchronize the display and memory. 
Nap busy loops until the time is up; sleep is identical except that it gives up the processor for the interval. 
Except when unwilling to give up the mouse, a program should call sleep in preference to nap. Sleep does 
not interfere with alarm, and vice versa. 


Realtime returns the number of 60Hz clock ticks since mux started. 


Kbdchar returns the next keyboard character typed to the process. If no characters have been typed, or 
KBD has not been requested, kbdchar returns —1. 


Revchar returns the next character received from the host, typically written on the standard output of a Unix 
process. If there are no characters available, or RCV has not been requested, rcvchar returns —1. 


Sendchar sends a single byte to the host, which will normally be read on the standard input of the Unix pro- 
cess. Sendnchars sends to the host n characters pointed to by p. Sent by either routine, the characters are 
passed to the Unix teletype input routine, and will be processed as though they were typed on the keyboard 
by a user. 


Kill sends the Unix process associated with the terminal process the Unix signal (signal(2)) s, typically 
SIGINT=2. 


Exit terminates the process. Unlike on Unix, exit does not return an exit status to a parent. Calling exit 
replaces the running process by the default terminal program. Any associated Unix process must arrange 
for its own demise — exit is a purely local function. When a process calls exit, all local resources: key- 
board, mouse, storage, etc., are deallocated automatically. 


Page 2 


ADD (9.3) Eighth Edition ADD (9.3) 


NAME 


add, sub, mul, div, eqpt, eqrect, inset, muldiv, ptinrect, raddp, rsubp, rectXrect, rectclip — arithmetic on 
points and rectangles 


SYNOPSIS 


#include <jerg.h> 

Point add(p, q) Point p, q; 

Point sub(p, q) Point p, q; 

Point mul(p, a) Point p; int a; 

Point div(p, a) Point p; int a; 

int eqpt(p, q) Point p, q; 

int eqrect(r, s) Rectangle r, s; 

Rectangle inset(r, n) Rectangle r; int n; 

int muldiv(a, b, c) int a, b, c; 

int ptinrect(p, r) Point p; Rectangle r; 
Rectangle raddp(r, p) Rectangle r; Point p; 
Rectangle rsubp(r, p) Rectangle r; Point p; 
int rectXrect(r, s) Rectangle r, s; 


int rectclip(rp, s) Rectangle «rp, s; 


DESCRIPTION 


Add returns the Point sum of its arguments: (p.x+q.x, p.y+q.y). Sub returns the Point difference of its argu- 
ments: (p.x—-q.x, p.y—q.y). Mul returns the Point (p.x*a, p.y*a). Div returns the Point (p.x/a, p.y/a). 


Egqpt and eqrect return the equality of their arguments: 0 if unequal, | if equal. Two Points or Rectangles 
are equal if their corresponding coordinates are equal. 


Inset returns the Rectangle (r.origin.xt+n, r.origin.y+n, r.corner.x—n, r.corner.y-n). The following code 
creates a clear rectangle r with a 2-dot wide border inside r: 


rectf(&display, r, F_OR); 
rectf(&display, inset(r, 2), F CLR); 


Muldiv is a macro that returns the 16-bit result (a*b)/c, with (a*b) calculated to 32 bits, so no precision is 
lost. Muldiv is convenient for calculating transformations. 


Ptinrect returns | if p is a point within r, and 0 otherwise. 


Raddp returns the Rectangle (add(r.origin, p), add(r.corner, p)); rsubp returns the Rectangle 
(sub(r.origin, p), sub(r.corner, p)). 


RectXrect returns | if r and s share any point; 0 otherwise. 


Rectclip clips in place the Rectangle pointed to by rp so that it is completely contained within s. The return 
value is | if any part of *rp is within s. Otherwise, the return value is 0 and *rp is unchanged. 


SEE ALSO 
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NAME 


alloc, free, balloc, bfree, gcalloc, gcfree — allocate memory 


SYNOPSIS 


#include <jerg.h> 

char *alloc(nbytes) unsigned nbytes; 

void free(s) char *s; 

Bitmap *«balloc(r) Rectangle r; 

void bfree(b) Bitmap *b; 

char *gcalloc(nbytes, where) unsigned long nbytes; char **where; 


void gcfree(s) char *s; 


DESCRIPTION 


Alloc corresponds to the standard C function malloc. It returns a pointer to a block of nbytes contiguous 
bytes of storage, or 0 if unavailable. The storage is aligned on 4-byte boundaries. Unlike malloc, alloc 
clears the storage to zeros. Free frees storage allocated by alloc. 


Balloc returns a pointer to a Bitmap large enough to contain the Rectangle r, or O for failure. The coordi- 
nate system inside the Bitmap is set by r: the origin and corner of the Bitmap are those of r. Bfree frees 
the storage associated with a Bitmap allocated by balloc. 


Gcalloc provides a simple garbage-compacting allocator. It returns a pointer to a block of nbytes contigu- 
ous bytes of storage, or 0 if unavailable. The storage is initialized to zeros. Where is a pointer to the user’s 
data where the location of the block is to be saved. The return value of gcalloc is stored in *where and will 
be updated after each compaction. Therefore, a program using gcalloc should never store the location of 
gcallocated memory anywhere other than the location handed to the allocator. Typically, this location is 
contained in a structure, such as a Bitmap (balloc uses gcalloc). Gecfree frees the storage block at p. 
Gcalloc is not for novices. 


SEE ALSO 
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NAME 


Code, addr, bitblt, point, rectf, screenswap, segment, texture — basic jerq graphics functions 


SYNOPSIS 


#include <jerg.h> 


typedef int Code; 
Code F_ STORE, F_XOR, F OR, F_CLR; 


Word *«addr(b, p) Bitmap «b; Point p; 
void bitblt(sb, r, db, p, f) Bitmap «sb, «db; Rectangle r; Point p; Code f; 


void point(b, p, f) Bitmap *«b; Point p; Code f; 

void rectf(b, r, f) Bitmap *b; Rectangle r; Code f; 

void screenswap(b, r, s) Bitmap *b; Rectangle r, s; 

void segment(b, p, q, f) Bitmap *b; Point p, q; Code f; 

void texture(b, r, t, f) Bitmap «b; Rectangle r; Texture *t; Code f; 


DESCRIPTION 


The type Code defines the constants passed to the graphics primitives to indicate the Boolean operation to 
be performed on the source and destination. The meanings of a Code are: 


F_ STORE target = source 
F OR target |= source 
F XOR target “= source 
F CLR target &= “source 


In other words, if a Rectangle is copied to another place with Code F_OR, the result will be the bitwise OR 
of the contents of the source Rectangle and the target area. For operations with no explicit source, such as 
line drawing, the source is taken to be an infinite bitmap with zeroes everywhere except on the object (e.g. 
line) generated by the operator, with coordinates aligned with the destination bitmap. F STORE is the 
same as F_OR for non-rectangular operations. 


Adar returns the address of the Word containing the bit at Point p in the Bitmap b. 


Bitblt (bit-block transfer) copies the data in Rectangle r in Bitmap sb to the congruent Rectangle with 
origin p in Bitmap db. The nature of the copy is specified by the Code f. 


Point draws the pixel at location p in the Bitmap b according to Code f. 


Screenswap does an in-place exchange of the on-screen Rectangle s and the Rectangle r within the Bitmap 
b. Its action is undefined if r and s are not congruent. The Rectangle s is not clipped to the Bitmap b, only 
to the screen. 


Segment draws a line segment in Bitmap b from Point p to qg, with Code f. The segment is half-open: p is 
the first point of the segment and gq is the first point beyond the segment, so adjacent segments sharing end- 
points abut. Like all the other graphics operations, segment clips the line so that only the portion of the line 
intersecting the bitmap is displayed. 


Texture draws with function specified by fin the Rectangle r, in the Bitmap b, the Texture specified by f. 
The texture is replicated to cover r. Rectf is equivalent to texture with *f set to all one’s. 


In the above definitions, the type Bitmap may be replaced with Layer anywhere; see newlayer(9.2). 


SEE ALSO 
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NAME 


circle, disc, arc, ellipse, eldisc, elarc — circle drawing functions for jerq 


SYNOPSIS 


#include <jerg.h> 

void circle(bp, p, r, f) Bitmap *bp; Point p; int r; Code f; 

void disc(bp, p, r, f) Bitmap *bp; Point p; int r; Code f; 

void arc(bp, p90, p1, p2, f) Bitmap «bp; Point p0, p1, p2; Code f; 

void ellipse(bp, p, a, b, f) Bitmap «bp; Point p; int a, b; Code f; 

void eldisc(bp, p, a, b, f) Bitmap «bp; Point p; int a, b; Code f; 

void elarc(bp, p0, a, b, p1, p2, f) Bitmap «bp; Point p0, p1, p2; int a, b; Code f; 


DESCRIPTION 


BUGS 
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Circle draws the best approximate circle of radius r centered at point p in the Bitmap bp with Code f. The 
circle is guaranteed to be symmetrical about the horizontal, vertical and diagonal axes. Disc draws the cor- 
responding disc. 


Arc draws a circular arc centered on pO, travelling counter-clockwise from p/ to the point on the circle 
closest to p2. 


Ellipse draws an ellipse centered at p with horizontal semi-axis a and vertical semi-axis b in Bitmap bp 
with Code f. Eldisc draws the corresponding elliptical disc. Elarc draws the correspoding elliptical arc, 
travelling counter-clockwise from the ellipse point closest to p/ to the point closest to p2. (Beware the 
regrettable difference between the calling conventions for arc and elarc.) 


When an endpoint of an arc lies on a tail of an ellipse so thin that its ends degenerate into straight lines, 
elarc does not try to distinguish which ‘side’ of the tail the point belongs on. 
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NAME 

cos, sin, atan2, sqrt, norm — integer math functions 
SYNOPSIS 

int cos(d) int d; 

int sin(d) int d; 


int atan2(x, y) int x, y; 
int norm(,, y, Z) int x, y, z; 
int sqrt(x) long x; 


DESCRIPTION 
Cos and Sin return scaled integer approximations to the trigonometric functions. The argument values are 
in degrees. The return values are scaled so that cos(0)=1024. Therefore, to calculate, for example, the 
mathematical expression x=x0*cos(d), the multiplication must be scaled: 


x=muldiv(xO, cos(d), 1024). 


Atan2 returns the approximate arc-tangent of y/x. The return value is in integral degrees. The approxima- 
tion is poor; the error may be as large as two degrees. 


Sqrt returns the 16-bit signed integer closest to the square root of its 32-bit signed argument. 
Norm returns the Pythagorean length of the three-vector (x, y, z). 


DIAGNOSTICS 
Atan2 (0, 0) and sqgrt(O) return 0. Norm does not protect against overflow. 
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NAME 

menuhit — present user with menu and get selection 
SYNOPSIS 

#include <jerq.h> 


int menuhit(m, n) 
Menu *m; int n; 
DESCRIPTION 

Menuhit presents the user with a menu specified by the Menu pointer m and returns an integer indicating 
the selection made, or —1 for no selection. The integer 1 specifies which button to use for the interaction: 1, 
2 or 3. Menuhit assumes that the button is already depressed when it is called. The user makes a selection 
by lifting the button when the cursor points at the desired selection; lifting the button outside the menu indi- 
cates no selection. 


Menus can be built in two ways, either as an array of strings or with a generator function: 


char *menutext[]={"Item 0", "Item 1", "Item 2", 0}; 
Menu stringsmenu={ menutext }; 


or 


char *menugen(); 
Menu genmenu={ (char **)0, menugen }; 


The generator function is passed an integer parameter n, and must return the string for the n’th menu entry, 
or 0 if n is beyond the number of entries in the menu. 


Regardless of the method of generation, characters with the 0200 bit set are regarded as fill characters. For 
example, the string "\240X" will appear in the menu as a right-justified X. Menu strings without fill charac- 
ters are drawn centered in the menu. 


Here is an example, using the list-of-strings menu defined above: 


switch(menuhit(&stringsmenu, 3)){/* Use right button */ 


case 0: 
item_0(0); 
break; 
case |: 
item_1(); 
break; 
case 2: 
item_2(); 
break; 
case —1: 
noselection(); 
break; 
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NAME 


string, defont, strwidth, infont, outfont, getfont — jerq text and font operations 


SYNOPSIS 


#include <jerq.h> 
#include <font.h> 


Point string (ft, s, b, p, f) Font «ft; char *s; Bitmap *b; Point p; Code f; 
extern Font defont; 

int strwidth(ft, s) Font «ft; char *s; 

Font *infont(inch) int (*«inch)Q; 

int outfont(ft, ouch) Font «ft; int («ouch)(0; 

void ffree(ft) Font «ft; 

#include <jerqio.h> 

Font «getfont(file) char *file; 


DESCRIPTION 
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String draws the null-terminated string s using characters from font ft in Bitmap b at Point p, with Code f. 
The return value is the location of the first character after s; passed to another call to string, the two strings 
will be concatenated. The characters are drawn such that the origin point of the bounding rectangle of a 
maximum height character lies at p. Therefore, a character drawn on the screen at (0, 0) will occupy the 
upper-leftmost character position on the screen. String draws characters as they are in the font. No special 
action is taken for control characters such as tabs or newlines. 


The global defont is the name of the standard font (not a pointer to it). 


Strwidth returns the width in pixels of the null-terminated string s, interpreted in the Font */t. The height 
of a character string is simply ft->height. 


Infont creates a font by reading the byte-wise binary representation returned by successive calls to inch. It 
returns 0 on error. Jnch must return successive bytes of the Unix file representation of the font, and —1 at 
end-of-file. Outfont calls the routine ouch to write successive bytes of the binary representation of font ft. 
It returns —1 on error, as must ouch . For programs running under jx, getfont returns a pointer to a font read 
from the named file, essentially by calling infont with argument routine gefc. It returns 0 on error. Ffree 
frees a font allocated by infont or getfont. 
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NAME 
jioctl — jerq ioctl requests 
SYNOPSIS 
#include /usr/jerq/include/jioctl.h 
ioctl(fd, JMUX, 0) 
ioctl(fd, request, win) 
struct winsize *win; 
DESCRIPTION 
Mux(9.1) supports several jerq-specific ioctl(2) requests for Unix programs attached to layers. The requests 


are: 560361.sp48u 
JMUX returns 0 if file descriptor fd is connected to a mux layer, —1 otherwise. 


JTERM resets the layer connected to fd to the default terminal program. 


JBOOT initiates the down-load protocol to replace the layer’s terminal program. Usually called by 
321d(9.1). 


JZOMBOOT 
is the same as JBOOT, but disables execution of the program when the download is complete (see 
the -z flag of 32/d). 


JWINSIZE 
returns, in the location pointed to by the third argument, a structure describing the size of the layer 
connected to fd. The structure is: 


struct winsize { 
char __ bytesx, bytesy; /* size in characters */ 
short _ bitsx, bitsy; /* size in pixels */ 
}s 
JEXIT causes mux to exit. 


SEE ALSO 
321d(9.1), mux(9.1), ioctl(2) 
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NAME 


mouse — jerq mouse user interface 


DESCRIPTION 


BUGS 
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Most jerq programs use the mouse for control, either by pointing at things on the screen or by making 
selections from a menu. The mouse buttons are different from keys on a keyboard in that events are 
reported when a button is released (let ‘up’) as well as depressed (pressed “down’). It therefore matters not 
only where and when a button is pressed, but for how long. For example, menus are drawn when a button 
is depressed, and remain displayed as long as the button is held down. While the button is down, moving 
the cursor over the menu highlights entries in the menu; the entry (possibly none) under the cursor when the 
button is released is the selection returned to the program. Large menus also present a scroll bar on the left 
side of the menu. Moving the mouse inside the scroll bar chooses which subset of the available entries are 
displayed and therefore selectable. 


There is a convention about how the buttons are used. The left button (button 1) is used to point: selecting 
which layer to work in, which file inside the editor, some text in the file, etc. The middle button (button 2) 
produces a menu of actions related to the selection: remove the selected text, replace it, etc. The right but- 
ton (button 3) presents a menu of global, program-wide actions: pick up a new file, rearrange the files on 
the screen, etc. Programs follow this convention well enough that an unfamiliar program can often be 
learned simply by trying it. The main violators of the convention are drawing programs, which use button 
1 to draw things and button 2 to undraw them, but this is also a consistent convention. 


The mouse cursor is usually an arrow pointing at a pixel, but programs often change the cursor to an iconic 
representation of the program’s state. The most common cursors are: 


arrow _ standard cursor 


coffee cup 
program will be busy for a while 


rectangle and arrow 
program expects a rectangle to be ‘swept out’ by pressing a button (usually 3) at one corner and 
releasing at the diagonally opposite corner 


gunsight 
program expects an object to be selected by pointing at it and pressing a button (usually 3) 


upside-down mouse 
program is thinking; the mouse is inoperative 


It’s still necessary to use the keyboard sometimes. 
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NAME 


bitfile — format of bitmap file 


DESCRIPTION 


Binary files produced by blitbit(9.1), twid(9.6) and other bitmap-generating programs are formatted as fol- 
lows: 


Byte no. Description 

0, 1: Zero. 

2, 3: X-coordinate of the rectangle origin (low-order byte, high-order byte). 

4,5: Y-coordinate of the rectangle origin (low-order byte, high-order byte). 

6, 7: X-coordinate of the rectangle corner (low-order byte, high-order byte). 

8, 9: Y-coordinate of the rectangle commer (low-order byte, high-order byte). 

remainder: | Compressed raster data. Each raster is exclusive-or’d with the previous one, and zero- 


extended (if necessary) to a 16-bit boundary. It is then encoded into byte sequences, each of 
which consists of a control byte followed by two or more data bytes: 


Control Data 
n (< 127) 2*n bytes of raster data, running from left to right. 
0x80 +n 2 bytes of raster data, to be replicated from left to right n times. 


There are also two ASCII formats in current use. Textures and 16x16 icons, typically created by icon(9.1), 
are encoded as a Texture declaration with initializer, to be copied unchanged into C program source; see 
types(9.5). Faces and other large icons are without any surrounding C syntax. In either case, each scan 
line of the bitmap is a comma-separated list of C-style short hexadecimal constants; scan lines are separated 
by newlines. 


SEE ALSO 
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blitblt(9.1), icon(9.1), twid(9.1), types(9.5), sysmon(9.1), can(1) 
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NAME 


faced — network face server 


SYNOPSIS 


/usr/net/face.go 


DESCRIPTION 


FILES 


The network face server provides a database of 48x48 bit icons and other facial representations. It is imple- 
mented as a network file system similar to netfs(8). 


The file system, conventionally mounted on /n/face, has a fixed three-level hierarchy. The first level is a 
machine name, the second level a user name, and the third level a resolution. Thus the file 
/n/face/kwee/pjw/48x48x1 is the standard face icon (for user pjw) on machine kwee: 


Many local users also have 512x512 byte high-resolution faces, named 512x512x8. Other resolutions may 
also be present for a particular face. One-bit images are stored in the format used by icon(9.1); eight-bit 
images are arrays of bytes. The directories for machines sharing a user community, such as those on a 
Datakit node, are linked together and given a name appropriate to the community. For example, 
/n/face/kwee is a link to /n/face/astro. 


To access the face for a mail name machine ‘uid take the result of the first successful open from the follow- 
ing list of files: 


/n/face/machine/uid/48x48x 1 
/n/face/misc./uid/48x48x1 
/n/face/machine/unknown/48x48x 1 
/n/face/misc./unknown/48x48x 1 


The directory misc. holds faces for generic users such as root and uucp. The face server is made available 
on a machine by running /usr/net/face.go from rc(8). 


The face server data is kept on kwee, and is administered by a pair of ASCII files that associate related 
machines and faces. The machine table machine.tab attaches machines to communities; the line 


kwee=astro 


puts the machine kwee in community astro. The people table associates a machine/user pair in the face 
server with a file on kwee; 


astro/pjw=pjweinberger 


causes the images stored in disk files named pjweinberger to be available in the face server in directory 
/n/face/astro/pjw. As well, each disk file used by the face server is linked (by its original name) into the 
directory /n/face/48x48x1 or /n/face/512x512x8 for easy access to all the images. 


/n/kwee/ust/jerg/icon/face48 directory of low resolution faces 
/n/kwee/t0/face/5 12x512x8 directory of high resolution faces 
/n/kwee/usr/net/face/people.tab —_ people/file equivalences 
/n/kwee/usr/net/face/machine.tab machine/community equivalences 


SEE ALSO 


BUGS 
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netfs(8), face(9.1), icon(9.1), sysmon(9.1) 


After updating the tables, an indeterminate time may pass before the new faces are available. 
All face server files are unwritable. 
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NAME 


font — jerq font layouts 


SYNOPSIS 


#include <jerg.h> 
#include <font.h> 


typedef struct Fontchar Fontchar; 
typedef struct Font Font; 


extern Font defont; 


DESCRIPTION 


A Font is a character set, stored as a single Bitmap with the characters placed side-by-side. It is described 
by the following data structures. 


typedef struct Fontchar { 


short x; /* left edge of bits */ 
unsigned char top; /* first non-zero scan-line */ 
unsigned char bottom; /* last non-zero scan-line */ 
char left; /* offset of baseline */ 
unsigned char width; /* width of baseline */ 
} Fontchar; 
typedef struct Font { 
short n; /* number of chars in font */ 
char height; /* height of bitmap */ 
char ascent; /* top of bitmap to baseline */ 
long unused; 
Bitmap *bits; /* where the characters are */ 
Fontchar info[n+1]; /* n+1 character descriptors */ 
} Font; 


Characters in bits abut exactly, so the displayed width of the character c is Font.info[c+1].x—Font.info[c].x. 
The first /eft columns of pixels in a character overlap the previous character. The upper left corner of the 
nonempty columns appears at (x,0) in the bitmap. Width is the distance to move horizontally after drawing 
a character. The font bitmap has a fixed height; parameters top and bottom may be used to optimize the 
copying of a character in some circumstances. 


A character drawn at point p in an arbitrary Bitmap has its upper-leftmost dot, including empty space above 
it in the Bitmap, at p. 


To copy character c from font f to point p do 


Fontchar *i = f->info + c; 

bitblt(f—>bits, RectGi—>x, i—>top, (i+ 1)—>x, i->bottom), Pt(p.x+i—>left, p.y+i—>top), fc); 

p-X += i->width; 
The above example is correct for XOR and OR mode. For STORE mode, the bitblt call is different because 
all the scan lines must be drawn: 

bitblt(f—>bits, Rect(@i—>x, 0, (i+ 1)—>x, f—>height), Pt(p.x+left, p.y), fc); 


Fonts are stored on disk in binary with byte order that of the terminal. First in the file is the first eight bytes 
(up to unused) of the Font strcture, then the array of Fontchar structures, then the data for the bitmap 
Font.bits. The header for the bitmap must be inferred from Font.height and Font.info[Font.n].x. See 
string (9.3) for a description of how to read and write font files. 


SEE ALSO 
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jf(9.1), string(9.3), infont(9.3) 
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NAME 
pads — user interface package 

DESCRIPTION 
Pads is a user interface package for browser-like applications. Interaction with its multiple windows is 
modeled after jim(9.1). 
Mouse 
The left button points. Pointing at a window makes it current, with a heavy border; pointing at a line makes 
it current, inverts its video, and moves it to the middle of the window. The scroll bar at the left of each 
window shows how much of the text of a window is visible; pointing into the scroll region controls what 
text is displayed. The middle button menu has operations that apply to the current line. Operations above 
the ~~~ separator are specific to each line; operations below the separator are generic line operations: 
cut removes the line. 
sever removes the line and all lines above it. 
fold folds a line that is wider than its window, so all of it appears. 
truncate truncates a wide line at the right, so it occupies only one physical line. 
The right button menu has window-level operations, and is in three parts. Below the lower separator is a 
list of all the available windows; selecting one makes it current. They appear in front-to-back screen order, 
current at the top. Operations above the upper separator are specific to each window; operations between 
the separators are generic window operations: 
reshape, move, close the usual. 
fold, truncate apply to all the lines in the window. 
Keyboard 
Keyboard characters accumulate at the bottom of the layer. If the current line accepts input, it flashes with 
each keystroke; otherwise, if the current window accepts input, its border flashes. Carriage return is 
ignored until a line or window accepts the text, whereupon the input line is sent to the line or window. The 
ESC key substitutes the mux(9.1) global snarf buffer. If the first character of a line from the keyboard is <, 
the remainder is interpreted as a shell command; each line of its standard output is sent to the line or win- 
dow. Each line or window that accepts keyboard input produces some help in response to ?. 
Cursor Icons 
arrow-dot-dot-dot the host is completing an operation; the terminal is ready asynchronously. 
exclamation mark confirm a dangerous menu selection by pressing that menu’s button again. 
The Hard Part 
Remember that the middle button operates on lines and the right button operates on windows. In many 
cases, both menus are useful, but you can see only one at a time. 

SEE ALSO 
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Pads Programming Guide by T. A. Cargill 


TYPES (9.5 ) Eighth Edition TYPES (9.5) 


NAME 


Word, Point, Rectangle, Bitmap, Texture, Pt, Rect, Rpt, display, Drect, Jrect — basic jerq graphics data 
types 


SYNOPSIS 


#include <jerg.h> 


typedef int Word; 

typedef struct Point Point; 

typedef struct Rectangle Rectangle; 
typedef struct Bitmap Bitmap; 
typedef struct Texture Texture; 


extern Bitmap display; 
extern Rectangle Drect, Jrect; 


Point Pt(x, y) int x, y; 
Rectangle Rect(x0, yO, x1, y1) int x0, yO, x1, y1; 
Rectangle Rpt() Point p90, p1; 


DESCRIPTION 
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A Word is a 32-bit integer, and is the unit of storage used in the graphics software. 
A Point is a location in a Bitmap (see below), such as the display, and is defined as: 


typedef struct Point { 
short x; 
short y; 
} Point; 
The coordinate system has x increasing to the right and y increasing down. All objects and operators in the 
graphics live in the same coordinate space — that of the display bitmap. 
A Rectangle is a rectangular area in a Bitmap. 
typedef struct Rectangle { 
Point origin; /* upper left */ 
Point corner; /* lower right */ 
} Rectangle; 


By definition, origin.x<=corner.x and origin.y<=corner.y. By convention, the right (maximum x) and bot- 
tom (maximum y) edges are excluded from the represented rectangle, so abutting rectangles have no points 
in common. Thus, corner is the coordinates of the first point beyond the rectangle. The image on the dis- 
play is contained in the Rectangle {0, 0, XMAX, YMAX}, where XMAX=800 and YMAX=1024. 


A Bitmap holds a rectangular image, stored in contiguous memory starting at base. 


typedef struct Bitmap { 


Word = *base; /* pointer to start of data */ 

unsigned width; /* width in Words of total data area */ 

Rectangle rect; /* rectangle in data area, screen coords */ 
} Bitmap; 


Each width Words of memory form a scan-line of the image, and rect defines the coordinate system inside 
the Bitmap: rect.origin is the location in the Bitmap of the upper-leftmost point in the image. The coordi- 
nate system is arranged so x positions equal to 0 mod 16 are in the leftmost bit of a Word. 


A Texture is a 16X16 dot bit pattern. 


typedef struct { 
Word bits[16]; 
} Texture; 
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Textures are aligned to absolute display positions, so adjacent areas colored with the same Texture mesh 
smoothly. 


The functions Pr, Rect and Rpt construct geometrical data types from their components. Since they are 
implemented as macros, they only work in function argument lists. 


The global display is a Bitmap describing the display area of the process. Drect is a Rectangle defining, in 
screen coordinates, the display area available to the program (inside the layer’s border). Jrect is the Rectan- 
gle {0, 0, XMAX, YMAX}. 
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NAME 

crabs — graphical marine adventure game 
SYNOPSIS 

crabs [ -i ] [ -s duration ] [ -v velocity ] [ number | 
DESCRIPTION 

In crabs, difficult situations are encountered in trying to kill or capture crustaceans swarming in a murky 

sea. You will have to work very rapidly to keep your territory free of seabed intruders. At first, you may 

even find it hard to keep a clear view of your surroundings, but later discoveries about the spirit of the game 
will suggest a solution. 

There are several options. 

-i causes the intruders to play intelligently, allowing them to avoid detection. 

-s simplifies the game for the first duration time intervals. Default is 0. 5-10 is recommended for 
beginners, although you may want to forgo this option the first time, just to see how interesting it 
can get. 

-v adjusts the velocity of the crabs, | being fastest. Default is 5. 

Number specifies the number of intruders. Default is 30. 

FILES 
/usr/jerq/mbin/crabs.m — terminal program 
CRUSTACEANS 
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Can be frustrating. 
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NAME 
demo — graphic demonstrations and games 
SYNOPSIS 
demo [ name ] 
DESCRIPTION 
If a demo is named, demo runs it, otherwise demo produces a list of what’s available. 
Games that permit interaction are often controlled by the mouse; experiment to find out what it does. Some 
less obvious interactions are listed below. 
Swar is a two-player game. One player uses the ‘asdwx’ keys, the other ‘12350’ keys on the keypad. 
Pacman is controlled by the ‘hjkl’ keys or the mouse. 
SEE ALSO 
crabs(9.6) 
BUGS 


Some of the programs don’t play fair. 
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NAME 


pen — doodle anywhere on the screen 


SYNOPSIS 


pen 


DESCRIPTION 


BUGS 
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Pen writes on the screen with smooth strokes. It can scribble on layers or on the background, even while 
other programs are running. It can be used to make drawings, marks or annotations, or to highlight regions 
in acrowded screen. Pen never needs refilling. 


To write, press mouse button | and keep it pressed while moving the mouse. To move around without writ- 
ing, release the button. Button 3 controls a menu to stop drawing (allowing one to resume normal activi- 
ties), resume drawing, clean up, or exit the program. 


When drawing too fast, the pen can temporarily run out of ink; when this happens release button | and 
press it again. To avoid this problem, make the pen layer bigger (that is where the ink supply is kept). 
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NAME 
twid — dabble in oils 
SYNOPSIS 
twid 
DESCRIPTION 
Twid is an oil paint program for bitmaps. Button 3 presents a palette (menus of paints are unappetizing), 
and buttons | and 2 apply paint. 
The palette contains a list of names of subpalettes. After making a selection, depress again to display the 
subpalette. The palette names are: 
style | Choose drawing style: ink (Rembrandt), point (Seurat), line (Mondrian), curve (Matisse) and disk 
(Disney). 
texture selects a texture (paint) to be applied with the brush. The default set of textures is sufficient for 
Lichtenstein. Use the <new> button to create new ones: use button 1 (2) to select the area under 
the cursor (its bitwise complement), and type a name for twid to call it. 
brush _ selects the brush size and shape. Predefined brushes are square, for effects ranging from Dali to 
Van Gogh; to be more modern use <new> (again, you must name the new brush). 
buttons By default, button 1 puts paint down and button 2 picks it up again. This palette lets you change 
that behavior. 
copy __ provides commands for moving and rotating sections of the picture. 
unix offers commands for reading and writing files, and exiting. 
The current style, texture and brush are indicated in their palettes by an asterisk ‘*’. 
SEE ALSO 
paint(9.1) 
BUGS 
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Green is not the color of choice for oils. 
Jackson Pollocks are time consuming. 


